NdisGetDriverHandle function
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
NdisGetDriverHandle retrieves a handle to the miniport driver that owns the adapter port that is referenced by a caller-supplied handle.
Syntax
VOID NdisGetDriverHandle(
_In_ NDIS_HANDLE NdisBindingHandle,
_Out_ PNDIS_HANDLE NdisDriverHandle
);
Parameters
NdisBindingHandle [in]
Pointer to a handle to the bound adapter port for which a handle to the miniport driver is to be retrieved. Typically, NdisBindingHandle is returned by NdisOpenAdapter.NdisDriverHandle [out]
Pointer to a caller-supplied variable. If the call succeeds, NdisGetDriverHandle returns a handle to a miniport driver in this caller-supplied variable. This miniport driver exports the bound adapter port that is specified by NdisBindingHandle.
Return value
None
Remarks
An adapter port is exposed in the NdisBindingHandle binding. A protocol driver uses NdisGetDriverHandle to retrieve a handle to the miniport driver that owns this adapter port. The protocol driver cannot use the handle to the miniport driver for any purpose other than identifying the miniport driver for a given binding.
A protocol driver retrieves the same handle to the miniport driver in NdisDriverHandle for all bindings to adapter ports that are exported by the same miniport driver. A protocol driver typically uses NdisGetDriverHandle to check if two bound adapter ports that were opened by the protocol are owned by the same miniport driver.
Requirements
Target platform |
Universal |
Version |
Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP. |
Header |
Ndis.h (include Ndis.h) |
Library |
Ndis.lib |
IRQL |
<= DISPATCH_LEVEL |
See also