MB_FakeEntryToParent

C Specification

#include <nitro/mb/mb_fake_child.h>

BOOL MB_FakeEntryToParent( u16 index );

Arguments

index The parent's management index, obtained during scanning. Specify this index to gain entry to the parent. This index is obtained from the member of the scanning callback structure MBFakeScanCallback.

Return Values

TRUE if the argument is a valid parent index. FALSE otherwise.

Description

This function begins entry to a multiboot parent. The parent's specifications are performed using the parent's management index obtained during scanning. Executing this function leads automatically to this series of processes: Connect to parent -> Entry process -> Pseudo-download process -> Boot peparations -> Disconnect The execution status is reported by the callback function set by the MB_FakeSetCStateCallback function. All processes have ended when the MB_COMM_CSTATE_BOOT_READY callback is posted, so then you can quit the multiboot process using the MB_FakeEnd function and begin the process of reconnecting to the parent. If you cannot gain entry to the parent or if the process terminates abnormally due to a communication error, you must end the multiboot process using the MB_FakeEnd function and begin again using the MB_FakeInit function.

See Also

MB_FakeInit, MB_FakeEnd, MB_FakeSetCStateCallback

Revision History

11/25/2004 Initial version.