NdisQueryAdapterInstanceName 函数 (ndis.h)

  • 项目

NdisQueryAdapterInstanceName 函数检索调用协议驱动程序绑定到的物理 NIC 或虚拟适配器的友好名称。

语法

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

参数

pAdapterInstanceName

指向调用方提供的NDIS_STRING类型的指针，该类型接收计数的 Unicode 字符串。 此字符串指定绑定引用的接口的友好名称。 此接口是物理 NIC 或虚拟适配器。 对于 Windows 2000 及更高版本，NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。

[in] NdisBindingHandle

一个句柄，标识与调用方绑定到的下一低级驱动程序的目标物理 NIC 或虚拟适配器的绑定。 通常， NdisBindingHandle 由 NdisOpenAdapterEx 函数返回。

返回值

如果已成功分配 AdapterInstanceName 处字符串的内存，则 NdisQueryAdapterInstanceName 返回NDIS_STATUS_SUCCESS;否则，它将返回NDIS_STATUS_RESOURCES。

注解

协议驱动程序使用 NdisQueryAdapterInstanceName 检索物理 NIC 或协议驱动程序绑定到的虚拟适配器的友好名称。 协议驱动程序在 NdisBindingHandle 中指定此类 NIC 或虚拟适配器的句柄。 协议驱动程序调用 NdisOpenAdapterEx 函数来检索此句柄。

NdisQueryAdapterInstanceName 为指定友好名称的字符串分配内存。 调用方完成使用此内存后，调用方必须调用 NdisFreeMemory 函数来释放内存。

友好名称旨在帮助用户快速准确地识别物理 NIC 或虚拟适配器，例如，“PCI 以太网适配器”和“虚拟专用网络适配器”被视为友好名称。

要求

要求 值
最低受支持的客户端 支持 NDIS 6.0 和 NDIS 5.1 驱动程序 (请参阅 Windows Vista 中的 NdisQueryAdapterInstanceName (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisQueryAdapterInstanceName (NDIS 5.1) ) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_Miscellaneous_Function (ndis)

另请参阅

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING