MB_FakeStartScanParent

Syntax

#include <nitro/mb/mb_fake_child.h>

void MB_FakeStartScanParent( MBFakeScanCallbackFunc callback, u32 ggid );

Arguments

callback Specifies the callback function that notifies when a parent is discovered or lost.
This callback is called from within the interrupt handler.
ggid Specifies a 4-byte game group ID. Only parents with the specified ggid are discovered.

Return Values

None.

Description

This function scans for a multiboot parent. If a multiboot parent is discovered with a GGID that matches the ggid argument, the discovery is announced by the callback. Once this function is run, all usable channels will be continuously traversed and scanned for a multiboot parent that matches the specified GGID until the MB_FakeEndScan function is called. When a parent is discovered, the function returns MB_FAKESCAN_PARENT_FOUND in the callback. When a parent is lost, the callback returns MB_FAKESCAN_PARENT_LOST. If a communication error occurs, the function returns MB_FAKESCAN_API_ERROR.

See Also

MB_FakeEndScan, MBFakeScanCallbackFunc

Revision History

2005/06/01 Added text indicating that the callback is called from the interrupt handler.
2004/11/25 Initial version.


CONFIDENTIAL