NdisReadBindingInformation

NdisReadBindingInformation

VOID
   NdisReadBindingInformation(
       OUT PNDIS_STATUS Status,
       OUT PNDIS_STRING *Binding,
       IN NDIS_HANDLE ConfigurationHandle
       );

NdisReadBindingInformation returns a pointer to the name of a NIC under a driver’s Parameters key in the registry.

Parameters

Status

Points to a caller-supplied variable in which this function returns the status of the call as one of the following:

NDIS_STATUS_SUCCESS

The buffer at Binding contains a counted string, in the system-default character set, naming the adapter to which the caller will bind itself subsequently. For Windows NT drivers, this string contains Unicode characters.

NDIS_STATUS_FAILURE

The return value at Binding is NULL.

Binding

Points to a caller-supplied variable in which this function returns a pointer to the name that it retrieved from the registry.

ConfigurationHandle

Specifies the registry key handle returned by NdisOpenConfiguration.

Comments

NdisReadBindingInformation returns a pointer to a string that a higher-level NDIS driver can use to call NdisOpenAdapter. This function reads the registry to retrieve the name of the lower-level driver’s adapter to which the caller will bind itself.

NdisReadBindingInformation places this name in internally allocated storage that remains valid until the protocol calls NdisCloseConfiguration with the same ConfigurationHandle.

Callers of NdisReadBindingInformation run at IRQL PASSIVE_LEVEL.