NDIS_PD_ALLOCATE_COUNTER回调函数 (ndis.h)

  • 项目

PacketDirect (PD) 平台调用支持 PD 的微型端口驱动程序的 NdisPDAllocateCounter 函数来分配计数器对象。 有三种类型的计数器：

  • 接收队列计数器用于跟踪接收队列活动。
  • 传输队列计数器用于跟踪传输队列活动。
  • 筛选器计数器用于跟踪筛选器匹配活动。
注意 必须使用 NDIS_PD_ALLOCATE_COUNTER 类型声明函数。 有关详细信息，请参阅以下示例部分。
 

语法

NDIS_PD_ALLOCATE_COUNTER NdisPdAllocateCounter;

NTSTATUS() NdisPdAllocateCounter(
  [in]  NDIS_PD_PROVIDER_HANDLE ProviderHandle,
  [in]  const NDIS_PD_COUNTER_PARAMETERS *CounterParameters,
  [out] NDIS_PD_COUNTER_HANDLE *CounterHandle
)
{...}

参数

[in] ProviderHandle

标识支持 PD 的微型端口驱动程序的提供程序对象的提供程序句柄。

[in] CounterParameters

指定计数器类型等信息的 NDIS_PD_COUNTER_PARAMETERS 结构。

[out] CounterHandle

指向驱动程序分配的计数器句柄变量的指针。 如果计数器分配成功，微型端口驱动程序将返回此变量中新分配的计数器的句柄。

返回值

NdisPDAllocateCounter 可以返回以下状态值之一：

返回代码 说明
STATUS_SUCCESS
 微型端口驱动程序已成功分配计数器，并在 CounterHandle 参数中返回句柄。
STATUS_INSUFFICIENT_RESOURCES
 由于资源不足，分配失败。

注解

同一计数器对象可以与计数器类型相同的多个队列或筛选器对象相关联。 例如，如果有 5 个接收队列 (RQ1 到 RQ5) ,2 个接收计数器 (RC1 和 RC2) ，则接收计数器 RC1 可能与接收队列 RQ1、RQ2、RQ3 相关联，接收计数器 RC2 可能与接收队列 RQ4 和 RQ5 相关联。

示例

若要定义 NdisPDAllocateCounter 函数，必须先提供一个函数声明来标识要定义的函数类型。 Windows 为驱动程序提供一组函数类型。 使用函数类型声明函数可帮助 驱动程序的代码分析、 静态驱动程序验证程序 (SDV) 和其他验证工具查找错误，并且这是编写 Windows 操作系统驱动程序的要求。

例如，若要定义名为“ MyPDAllocateCounter”的 NdisPDAllocateCounter 函数，请使用 NDIS_PD_ALLOCATE_COUNTER 类型，如以下代码示例所示：

NDIS_PD_ALLOCATE_COUNTER MyPDAllocateCounter;

然后，按如下所示实现函数：

_Use_decl_annotations_
NTSTATUS
 MyPDAllocateCounter(
    NDIS_PD_PROVIDER_HANDLE  ProviderHandle,
    CONST NDIS_PD_COUNTER_PARAMETERS*  CounterParameters,
    NDIS_PD_COUNTER_HANDLE*  CounterHandle
    )
  {...}

NDIS_PD_ALLOCATE_COUNTER函数类型在 Ntddndis.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations批注可确保使用应用于头文件中NDIS_PD_ALLOCATE_COUNTER函数类型的注释。 有关函数声明要求的详细信息，请参阅 使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅 批注函数行为。

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 ndis.h
IRQL PASSIVE_LEVEL

另请参阅

NDIS_PD_COUNTER_PARAMETERS

NdisPDFreeCounter