NdisQueryAdapterInstanceName 函数 （ndis.h）
NdisQueryAdapterInstanceName 函数检索物理 NIC 或调用协议驱动程序绑定到的虚拟适配器的友好名称。
语法
NDIS_STATUS NdisQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
[in] NDIS_HANDLE NdisBindingHandle
);
参数
pAdapterInstanceName
指向接收计数 Unicode 字符串的调用方提供的NDIS_STRING类型的指针。 此字符串指定绑定引用的接口的友好名称。 此接口是物理 NIC 或虚拟适配器。 对于 Windows 2000 及更高版本，NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。
[in] NdisBindingHandle
一个句柄，用于标识调用方绑定到的下一个较低驱动程序的目标物理 NIC 或虚拟适配器的绑定。 通常，NdisBindingHandle 由 NdisOpenAdapterEx 函数返回。
返回值
NdisQueryAdapterInstanceName 如果成功分配了 AdapterInstanceName 处字符串的内存，则返回NDIS_STATUS_SUCCESS;否则，它将返回NDIS_STATUS_RESOURCES。
言论
协议驱动程序使用 NdisQueryAdapterInstanceName 检索协议驱动程序绑定到的物理 NIC 或虚拟适配器的友好名称。 协议驱动程序指定 NdisBindingHandle 中此类 NIC 或虚拟适配器的句柄。 协议驱动程序调用 NdisOpenAdapterEx 函数来检索此句柄。
NdisQueryAdapterInstanceName 为指定友好名称的字符串分配内存。 调用方使用此内存后，调用方必须调用 NdisFreeMemory 函数才能释放内存。
友好名称旨在帮助用户快速准确地识别物理 NIC 或虚拟适配器，例如，“PCI 以太网适配器”和“虚拟专用网络适配器”被视为友好名称。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序（请参阅 NdisQueryAdapterInstanceName （NDIS 5.1）。 支持 NDIS 5.1 驱动程序（请参阅 Windows XP 中的 NdisQueryAdapterInstanceName （NDIS 5.1）。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h （包括 Ndis.h） |
| 库 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_Miscellaneous_Function（ndis） |