The NdisMQueryAdapterInstanceName function retrieves the friendly name of a miniport adapter.
NDIS_STATUS NdisMQueryAdapterInstanceName( _Out_ PNDIS_STRING AdapterInstanceName, _In_ NDIS_HANDLE MiniportAdapterHandle );
- AdapterInstanceName [out]
A pointer to a caller-supplied NDIS_STRING type that receives a counted Unicode string. This string specifies the friendly name of the interface for the given miniport adapter. For Windows Vista and later versions of the Windows operating system, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.
- MiniportAdapterHandle [in]
The handle to the miniport adapter that was previously input to the MiniportInitializeEx function.
Returns NDIS_STATUS_SUCCESS if memory for the string at AdapterInstanceName was successfully allocated; otherwise, it returns NDIS_STATUS_RESOURCES.
A miniport driver uses NdisMQueryAdapterInstanceName to retrieve the friendly name of an interface that the miniport driver controls. This interface is either a physical NIC or a virtual adapter and is called a miniport adapter. The miniport driver specifies the handle to a miniport adapter in MiniportAdapterHandle . This handle to the miniport adapter is passed to the miniport driver's MiniportInitializeEx function to set up the miniport adapter for network I/O operations.
NdisMQueryAdapterInstanceName allocates memory for the string that specifies the friendly name. After the caller finishes using this memory, the caller must call the NdisFreeMemory function to release the memory.
Friendly names are intended to help the user quickly and accurately identify a physical NIC or virtual adapter--for example, "PCI Ethernet Adapter" and "Virtual Private Networking Adapter" are considered friendly names.
|Supported in NDIS 5.1, and NDIS 6.0 and later. For NDIS 5.1 drivers, see NdisMQueryAdapterInstanceName (NDIS 5.1).|
DDI compliance rules