MB_FakeStartScanParent


C Specification

#include <nitro/mb/mb_fake_child.h>

void MB_FakeStartScanParent( MBFakeScanCallbackFunc callback, u32 ggid );
    

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.

Arguments

callback Specifies the callback function for announcing when parents are discovered and lost.
ggid Specifies a 4-byte game group ID. Only parents with the specified ggid are discovered.

Return Values

None.

See Also

MB_FakeEndScan, MBFakeScanCallbackFunc

Revision History

11/25/2004 Initial version.