#include <nitro/mb/mb_fake_child.h>
void MB_FakeStartScanParent( MBFakeScanCallbackFunc callback, u32 ggid );
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. |
None.
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. The search for multiboot parents that match the specified GGID continues across all usable channels until MB_FakeEndScan
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
.
MB_FakeEndScan, MBFakeScanCallbackFunc
06/01/2005 Added text indicating that the callback is called from the interrupt handler.
11/25/2004 Initial version.