NdisMQueryAdapterInstanceName 函数 (ndis.h)

  • 项目

NdisMQueryAdapterInstanceName 函数检索微型端口适配器的友好名称。

语法

NDIS_STATUS NdisMQueryAdapterInstanceName(
  PNDIS_STRING pAdapterInstanceName,
  NDIS_HANDLE  MiniportHandle
);

参数

pAdapterInstanceName

指向调用方提供的NDIS_STRING类型的指针，该类型接收计数的 Unicode 字符串。 此字符串指定给定微型端口适配器的接口的友好名称。 对于 Windows Vista 和更高版本的 Windows 操作系统，NDIS 将NDIS_STRING类型定义为 UNICODE_STRING 类型。

MiniportHandle

之前输入到 的微型端口适配器的句柄 MiniportInitializeEx 函数。

返回值

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

注解

微型端口驱动程序使用 NdisMQueryAdapterInstanceName 检索微型端口驱动程序控制的接口的友好名称。 此接口是物理 NIC 或虚拟适配器，称为 微型端口适配器。 微型端口驱动程序在 MiniportAdapterHandle 中指定微型端口适配器的句柄。 微型端口适配器的此句柄将传递给微型端口驱动程序的 MiniportInitializeEx 函数，以设置用于网络 I/O 操作的微型端口适配器。

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

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

要求

要求 值
最低受支持的客户端 在 NDIS 5.1、NDIS 6.0 及更高版本中受支持。 有关 NDIS 5.1 驱动程序，请参阅 NdisMQueryAdapterInstanceName (NDIS 5.1) 。
目标平台 通用
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Miniport_Driver_Function (ndis)

另请参阅

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING