次の方法で共有

PPHYSICAL_COUNTER_OVERFLOW_HANDLERコールバック関数 (ntddk.h)

  • [アーティクル]

PPHYSICAL_COUNTER_OVERFLOW_HANDLERは、HalAllocateHardwareCounters ルーチンを介して取得されたカウンター リソースからのカウンター オーバーフローを処理するために、クライアント ドライバーによって実装されます。

構文

PPHYSICAL_COUNTER_OVERFLOW_HANDLER PphysicalCounterOverflowHandler;

void PphysicalCounterOverflowHandler(
  ULONGLONG OverflowBits,
  HANDLE OwningHandle
)
{...}

パラメーター

OverflowBits

オーバーフローしたカウンターを記述するビットマップを提供します。

OwningHandle

オーバーフロー カウンターが属するリソース セットに対応する HANDLE を提供します。

戻り値

何一つ

備考

このコールバック関数の実装を登録するには、PHYSICAL_COUNTER_RESOURCE_LIST型の構造体 halAllocateHardwareCounters を呼び出します。 PHYSICAL_COUNTER_RESOURCE_LISTで、ResourceTypeOverflow の PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR_TYPE を指定する PHYSICAL_COUNTER_RESOURCE_DESCRIPTOR 型構造体を指定します。

オーバーフロー ハンドラーのプロトタイプの例を次に示します。

VOID
PmuAwareOverflowHandler (
    _In_ ULONGLONG OverflowStatus,
    _In_ HANDLE OwningHandle
    )

/*++

Routine Description:

    This routine is the PMU Overflow Handler for a sharing driver.

Arguments:

    OverflowStatus - The counters which have overflowed.

    OwningHandle - The handle owning the counters.

Return Value:

    None.

--*/
{
}

オーバーフロー ハンドラーを登録するには、次のようなコードを使用します。

VOID
CreateOverflowDescriptor (
    _Inout_ PPHYSICAL_COUNTER_RESOURCE_LIST CounterResourceList,
    _In_ ULONG DescriptorIndex
    )
{

    CounterResourceList->Descriptors[DescriptorIndex].Type = ResourceTypeOverflow;
    CounterResourceList->Descriptors[DescriptorIndex].u.OverflowHandler = PmuAwareOverflowHandler;
}

このコールバックは IRQL = PROFILE_LEVEL で呼び出されます。 つまり、常にメモリ常駐である必要があります。 コールバックはできるだけ早く戻る必要があり、次の操作を試みないでください。

  • スピン ロックを取得または解放します。

  • メモリ内でロックされていないページ プールにアクセスする

  • ページング可能なルーチンを呼び出します。

コールバックは HAL によって処理されるため、オーバーフロー レジスタのクリアを処理する必要はありません。

必要条件

要件 価値
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ntddk.h
IRQL PROFILE_LEVEL