NdisOpenProtocolConfiguration

This function returns a handle for the HKEY_LOCAL_MACHINE\Comm\ProtocolName\Parms registry key.

At a Glance

Syntax

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 NDIS_STATUS_FAILURE 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 driver to which the caller will bind itself later. Value entries under this key contain protocol-installed, adapter-specific information.

ProtocolSection

Pointer to a counted string, specified in the system-default character set, naming the NDIS driver, effectively the adapter, for which the Parameters\ProtocolName key in the registry protocol section should be opened.

For NDIS drivers that have a ProtocolBindAdapter function, this pointer is the SystemSpecific1 input parameter to that function.

Remarks

Currently, the Windows CE version of this function is a stub that exists to make existing code compile without error; it does no actual work. Current protocol stack implementations for Windows CE have their own means for obtaining configuration information. If that changes in later releases of Windows CE, this function may be developed more fully.