NdisQueryBindInstanceName 函数 (ndis.h)
NdisQueryBindInstanceName 函数检索调用协议驱动程序将绑定到的物理 NIC 或虚拟适配器的友好名称。
语法
NDIS_STATUS NdisQueryBindInstanceName(
[out] PNDIS_STRING pAdapterInstanceName,
[in] NDIS_HANDLE BindingContext
);
参数
[out] pAdapterInstanceName
指向调用方提供的NDIS_STRING类型的指针，该类型接收计数的 Unicode 字符串。 此字符串指定绑定所引用的接口的友好名称。 此接口是物理 NIC 或虚拟适配器。 对于 Microsoft Windows 2000 及更高版本的操作系统，NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。
[in] BindingContext
标识绑定操作的 NDIS 上下文区域的句柄。 NDIS 将此句柄传递给 的 BindContext 参数 ProtocolBindAdapterEx 函数。
返回值
如果成功分配 pAdapterInstanceName 中字符串的内存，则 NdisQueryBindInstanceName 返回NDIS_STATUS_SUCCESS;否则，它将返回NDIS_STATUS_RESOURCES。
注解
协议驱动程序使用 NdisQueryBindInstanceName 检索物理 NIC 或协议驱动程序将绑定到的虚拟适配器的友好名称。 协议驱动程序指定 NDIS 在 中提供的绑定上下文 ProtocolBindAdapterEx 函数。
协议驱动程序可以使用 NdisQueryBindInstanceName 在绑定到适配器之前获取友好名称。
NdisQueryBindInstanceName 为指定友好名称的字符串分配内存。 调用方完成使用此内存后，调用方必须调用 NdisFreeMemory 函数来释放内存。
友好名称旨在帮助用户快速准确地识别物理 NIC 或虚拟适配器，例如，“PCI 以太网适配器”和“虚拟专用网络适配器”被视为友好名称。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisQueryBindInstanceName (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisQueryBindInstanceName (NDIS 5.1) ) 。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h (包括 Ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | NdisQueryBindInstanceName (ndis) |