Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function returns a handle for an NDIS network adapter driver's HKEY_LOCAL_MACHINE\Comm\DriverName\Parmsregistry key.
VOID NdisOpenConfiguration( OUT PNDIS_STATUS Status , OUT PNDIS_HANDLE ConfigurationHandle , IN NDIS_HANDLE WrapperConfigurationContext );
Parameters
Value | Description |
---|---|
NDIS_STATUS_SUCCESS | The value at ConfigurationHandleis valid. |
NDIS_STATUS_FAILURE | The key could not be opened. |
Remarks
With the handle returned by this function, an NDIS miniport can call the NdisReadConfigurationfunction one or more times to extract configuration information about its network adapter from the registry. A miniport can also call NdisReadNetworkAddresswith this handle to retrieve software-configurable network address information that was stored in the registry when its network adapter was installed in the current computer.
A miniport's installation script must store at least the following configuration information in the registry:
Drivers of network adapters on ISA buses usually get bus-relative configuration parameters for a network adapter from the registry with the NdisReadConfigurationfunction. Drivers of network adapters on other types of I/O buses can also call Ndis XXXbus-type-specific configuration functions to get bus-relative network adapter-specific configuration parameters suitable for calling functions, such as NdisMRegisterInterrupt, NdisMMapIoSpace, and/or NdisMRegisterIoPortRange.
A network adapter driver calls the NdisMSetAttributesor the NdisMSetAttributesExfunction to identify the type of I/O bus on which its network adapter is likely to be found before that driver calls any of the bus-type-specific configuration functions.
After a driver has consumed and, possibly, modified the registry configuration information, the driver must call the NdisCloseConfigurationfunction to release the handle obtained from this function and to free any temporary storage that NDIS allocated in the driver's calls to NdisReadConfiguration, NdisReadNetworkAddress, and/or NdisWriteConfiguration.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.0 and later | Ndis.h | Ndislib.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
MiniportInitialize, NdisCloseConfiguration, NdisMMapIoSpace, NdisMRegisterInterrupt, NdisMRegisterIoPortRange, NdisMRegisterMiniport, NdisMSetAttributes, NdisMSetAttributesEx, NdisOpenProtocolConfiguration, NdisReadConfiguration, NdisReadNetworkAddress, NdisReadPciSlotInformation, NdisRegisterProtocol, NdisWriteConfiguration