MB_FakeStartScanParent

C Specification

#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. 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.

See Also

MB_FakeEndScan, MBFakeScanCallbackFunc

Revision History

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