NDIS-Supplied Initialization and Registration Functions (NDIS 5.1)
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
During initialization, a miniport driver configures itself and registers with NDIS by calling configuration functions provided by NDIS. Some of these functions access configuration information written to the registry by the miniport driver's INF file.
The following initialization and registration functions are supplied by NDIS:
- NdisMInitializeWrapper
Initializes the NDIS Library data structures for the miniport driver.
- NdisMRegisterMiniport
Provides the NDIS Library with information about the miniport driver.
- NdisMSetAttributesEx
Informs the NDIS Library of the type of NIC supported by the miniport driver and passes the handle to the miniport driver's context area. NDIS will pass this handle in subsequent calls to MiniportXxx functions. This function can also change the default NIC time-out behavior and allows a driver to specify some additional flags, including flags that must be set by a deserialized miniport driver or an NDIS intermediate driver.
- NdisMGetDeviceProperty
Retrieves device objects required to set up communication with a NIC through a bus driver. For example, USB and IEEE 1394 bus drivers.
- NdisMQueryAdapterResources
Returns a list of hardware resources for a NIC.
- NdisMQueryInformationComplete
Indicates that a call to MiniportQueryInformation has completed. Called only by connectionless miniport drivers.
- NdisMSetInformationComplete
Informs the NDIS Library that the previous MiniportSetInformation operation has completed. Called only by connectionless miniport drivers.
- NdisOpenConfiguration
Supplies a handle that the caller can use to call NdisReadConfiguration, NdisWriteConfiguration, NdisOpenConfigurationKeyByIndex, or NdisOpenConfigurationKeyByName.
- NdisReadConfiguration
Uses the Parameters handle obtained by calling NdisOpenConfiguration to read key values stored in the registry at the keyword passed to NdisReadConfiguration.
- NdisWriteConfiguration
Uses the Parameters handle obtained by calling NdisOpenConfiguration to write key values into the registry at the keyword passed to NdisWriteConfiguration.
- NdisCloseConfiguration
Closes the handle to the registry that was opened with a call to NdisOpenConfiguration.
- NdisMRegisterAdapterShutdownHandler
Registers a NIC-driver-supplied MiniportShutdown function to be called when the system is shutting down.
- NDIS_INIT_FUNCTION
Marks a driver function to be run only once during initialization.
- NDIS_PAGEABLE_FUNCTION
Marks a driver function as pageable code.