共用方式為

NDIS_PD_ALLOCATE_COUNTER回呼函式 （ndis.h）

  • 發行項

PacketDirect （PD） 平臺會呼叫支援 PD 的迷你埠驅動程式 NdisPDAllocateCounter 函式來配置計數器物件。 計數器有三種：

  • 接收佇列計數器用於追蹤接收佇列活動。
  • 傳輸佇列計數器用於追蹤傳輸佇列活動。
  • 篩選計數器用於追蹤篩選比對活動。
Note 您必須使用 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
目標平臺 窗戶
標頭 ndis.h
IRQL PASSIVE_LEVEL

另請參閱

NDIS_PD_COUNTER_PARAMETERS

NdisPDFreeCounter