NdisOpenProtocolConfiguration

NdisOpenProtocolConfiguration returns a handle for the registry key in which a protocol driver's per-adapter information is stored.

VOID
  NdisOpenProtocolConfiguration(
    OUT PNDIS_STATUS  Status,
    OUT PNDIS_HANDLE  ConfigurationHandle,
    IN PNDIS_STRING  ProtocolSection
    ); 

Parameters

Status

Pointer to a caller-supplied variable that is set to NDIS_STATUS_SUCCESS or a failure status on return from this function.

ConfigurationHandle

Pointer to a caller-supplied variable in which this function returns the handle to the registry key for the named miniport driver to which the caller will bind itself later. Value entries under this key contain protocol-installed, adapter-specific information.

ProtocolSection

Pointer to a caller-supplied NDIS_STRING type containing a counted string, specified in the system-default character set. This counted string names the NDIS NIC driver, effectively the adapter, for which the per-adapter parameters key in the registry protocol section should be opened. For Windows 2000 and later protocols, this counted string contains Unicode characters. That is, for Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

This pointer is the SystemSpecific1 input parameter to the caller's ProtocolBindAdapter function.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

NdisOpenProtocolConfiguration returns a handle that the caller can pass subsequently to the Ndis..Configuration functions to retrieve or store information in the registry.

A protocol driver calls NdisOpenProtocolConfiguration to get a registry key handle to be passed subsequently to other Ndis..Configuration functions, such as NdisRead/WriteConfiguration or NdisOpenConfigurationKeyByName/Index, if its installation script stored adapter-specific configuration information in the protocol section of the registry from which the protocol sets up its bindings.

A protocol can call NdisOpenConfigurationKeyByName or NdisOpenConfigurationKeyByIndex to open any subkey of the registry key for which NdisOpenProtocolConfiguration returns the handle.

Windows 2000 and later protocols call kernel-mode support routines to open their own protocol-specific registry keys. For more information about these support routines, see the Summary of Kernel-Mode Support Routines and Power Management Support Routines.

Callers of NdisOpenProtocolConfiguration run at IRQL = PASSIVE_LEVEL.

See Also

ANSI_STRING, NdisCloseConfiguration, NdisInitializeString, NdisInitUnicodeString, NdisOpenConfigurationKeyByIndex, NdisOpenConfigurationKeyByName, NdisReadConfiguration, NdisWriteConfiguration, ProtocolBindAdapter, UNICODE_STRING