9.1.5 Using the DLL to Create a Handle

NcDetectCreateHandle requests the DLL to provide a handle for a NIC that is not present in the system. This is necessary when the user overrides detection and continues to configure a network card. The function prototype is as follows:

LONG NcDetectCreateHandle(
LONG lNetcardId,
INTERFACE_TYPE itBusType,
LONG lBusNumber,
PVOID *ppvHandle
);

Parameters

lNetcardId

Specifies a valid NIC type number.

itBusType

Specifies an enumerated value that describes the type of bus on which the NIC can be found.

lBusNumber

Specifies the zero-based number of the bus being searched by the upper-level detection algorithm.

ppvHandle

Points to a variable in which this function return the opaque handle.