NdisOpenProtocolConfiguration (Compact 2013)

3/26/2014

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

Syntax

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

Parameters

  • Status
    [out] Pointer to a caller-supplied variable that is set to NDIS_STATUS_SUCCESS or NDIS_STATUS_FAILURE on return from this function.
  • ConfigurationHandle
    [out] 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
    [in] Pointer to a counted string specified in the system-default character set, naming the NDIS driver, effectively the adapter, for which the **Parms\**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 of that function.

Return Value

The following table shows the return values for the status of this function.

Value

Description

NDIS_STATUS_SUCCESS

The handle at ConfigurationHandle.

NDIS_STATUS_FAILURE

NDIS could not assign a handle.

Requirements

Header

ndis.h

See Also

Reference

NDIS 5.x Legacy Functions
ProtocolBindAdapter