NdisRegisterAdapter (Windows Embedded CE 6.0)

1/6/2010

This function tells NDIS to create a new device instance.

Syntax

VOID NdisRegisterAdapter(
  PNDIS_STATUS Status,
  PWSTR MiniportDriverName,
  PWSTR AdapterInstanceName
);

Parameters

• Status
  [out] On return, contains the status of the operation.

• MiniportDriverName
  [in] The NULL-terminated name of the miniport driver that should be used to manage the adapter.

• AdapterInstanceName
  [in] The NULL-terminated name of the adapter instance to create.

Return Value

None.

Remarks

NdisRegisterAdapter is used to dynamically create new device instances. If the specified miniport driver is not loaded then it will be loaded and initialized by this function. The MiniportInitialize handler of the driver will then be invoked as part of the creation of the specified device instance.

Prior to calling this function, registry information for the miniport driver and adapter instance must be configured in HKEY_LOCAL_MACHINE\Comm as for any NDIS driver.

[HKEY_LOCAL_MACHINE\Comm\<MiniportDriverName>]
    "Group"="NDIS"
    "ImagePatch"="<driver>.dll"
[HKEY_LOCAL_MACHINE\Comm\<AdapterInstanceName>\Parms]
    "BusNumber"=dword:<busnumber>
    "BusType"=dword:<bustype>
    <other parameters as needed by the miniport driver, such as IRQ, IOAddr, TcpIP, and so on>

NdisRegisterAdapter should not be used for a NIC on a PCMCIA bus.

Requirements

See Also

Reference

NDIS Library Functions
IOCTL_NDIS_REGISTER_ADAPTER
DeviceIoControl
NdisDeregisterAdapter
MiniportInitialize