WDF_EXECUTION_LEVEL列挙 (wdfobject.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WDF_EXECUTION_LEVEL列挙型は、フレームワーク オブジェクトに対してドライバーが指定したイベント コールバック関数をフレームワークが呼び出す最大 IRQL を指定します。

構文

typedef enum _WDF_EXECUTION_LEVEL {
  WdfExecutionLevelInvalid = 0x00,
  WdfExecutionLevelInheritFromParent,
  WdfExecutionLevelPassive,
  WdfExecutionLevelDispatch
} WDF_EXECUTION_LEVEL;

定数

 
WdfExecutionLevelInvalid
値: 0x00
システムで使用するために予約されています。
WdfExecutionLevelInheritFromParent
フレームワークは、オブジェクトが IRQL = DISPATCH_LEVEL (DPC オブジェクトなど) を必要とするオブジェクトでない限り、オブジェクトの親の最大 IRQL 値を使用します。 ドライバーがWDF_EXECUTION_LEVEL型指定された値を指定しない場合、この値は既定値です。
WdfExecutionLevelPassive
フレームワークは常に IRQL = PASSIVE_LEVEL でオブジェクトのコールバック関数を呼び出します。
WdfExecutionLevelDispatch
フレームワークは、IRQL <= DISPATCH_LEVEL でオブジェクトのコールバック関数を呼び出します。 UMDF では使用できません。

注釈

ドライバーは、WDF_EXECUTION_LEVEL列挙型を使用して、オブジェクトのWDF_OBJECT_ATTRIBUTES構造体の ExecutionLevel メンバー を 指定します。

ExecutionLevel 値は、次のオブジェクトに指定できます。

  • フレームワーク ドライバー オブジェクト
  • フレームワーク デバイス オブジェクト
  • フレームワーク ファイル オブジェクト
  • フレームワークの一般的なオブジェクト
  • フレームワーク キュー オブジェクト (Framework バージョン 1.9 以降)
  • フレームワーク タイマー オブジェクト (Framework バージョン 1.9 以降)
Kmdf 既定では、フレームワーク はフレームワーク ドライバー オブジェクトの ExecutionLevel 値を WdfExecutionLevelDispatch に設定します。

Umdf 既定では、フレームワーク はフレームワーク ドライバー オブジェクトの ExecutionLevel 値を WdfExecutionLevelPassive に設定します。

他のすべてのオブジェクトの既定の ExecutionLevel 値は WdfExecutionLevelInheritFromParent です。

イベント コールバック関数の実行レベルの詳細については、「 Framework-Based ドライバーの同期手法」を参照してください。

要件

要件 値
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfobject.h (Wdf.h を含む)

こちらもご覧ください

WDF_OBJECT_ATTRIBUTES