DRIVER_OBJECT構造体 (wdm.h)

2025-08-15

各ドライバーオブジェクトは、読み込まれたカーネルモードドライバーのイメージを表します。 I/O マネージャーは 、DRIVER_OBJECT 構造体を割り当て、ドライバーの DriverEntry、 AddDevice、および省略可能な再初期化ルーチンとその Unload ルーチン (存在する場合) に入力パラメーターとして渡します。

ドライバーオブジェクトは部分的に不透明です。ドライバーライターは、ドライバーを初期化し、ドライバーがアンロード可能な場合にアンロードするドライバーオブジェクトの特定のメンバーについて知っている必要があります。ドライバーオブジェクトの次のメンバーは、ドライバーからアクセスできます。

構文

typedef struct _DRIVER_OBJECT {
  CSHORT             Type;
  CSHORT             Size;
  PDEVICE_OBJECT     DeviceObject;
  ULONG              Flags;
  PVOID              DriverStart;
  ULONG              DriverSize;
  PVOID              DriverSection;
  PDRIVER_EXTENSION  DriverExtension;
  UNICODE_STRING     DriverName;
  PUNICODE_STRING    HardwareDatabase;
  PFAST_IO_DISPATCH  FastIoDispatch;
  PDRIVER_INITIALIZE DriverInit;
  PDRIVER_STARTIO    DriverStartIo;
  PDRIVER_UNLOAD     DriverUnload;
  PDRIVER_DISPATCH   MajorFunction[IRP_MJ_MAXIMUM_FUNCTION + 1];
} DRIVER_OBJECT, *PDRIVER_OBJECT;

メンバーズ

Type

ドライバーオブジェクトのオブジェクト型識別子を指定します。 I/O マネージャーは、ドライバーオブジェクトを割り当てるときにこのフィールドを設定します。ドライバーは、このフィールドを使用または変更しないでください。

Size

ドライバーオブジェクト構造のサイズをバイト単位で指定します。 I/O マネージャーは、ドライバーオブジェクトを割り当てるときにこのフィールドを設定します。ドライバーは、このフィールドを使用または変更しないでください。

DeviceObject

ドライバーによって作成されたデバイスオブジェクトのリンクされたリスト内の最初のデバイスオブジェクトへのポインター。このフィールドは、1 つのドライバーによって作成されたすべてのデバイスを一覧にリンクします。ドライバーが IoCreateDevice を正常に呼び出すと、このメンバーは I/O マネージャーによって自動的に更新されます。ドライバーは、このメンバーとDEVICE_OBJECTの NextDevice メンバーを使用して、ドライバーが作成したすべてのデバイスオブジェクトの完全な一覧を走査できます。これは、ドライバーのアンロード中に、すべてのデバイスオブジェクトが適切にクリーンアップされるようにするために特に便利です。

Flags

ドライバーのさまざまな属性と状態を記述するシステム定義フラグが含まれています。このフィールドは、ドライバーオブジェクトの拡張可能なフラグの場所を提供します。これらのフラグは、I/O マネージャーおよびその他のシステムコンポーネントによって設定および管理されます。ドライバーは、このフィールドを直接変更しないでください。

DriverStart

ドライバーイメージがシステムメモリに読み込まれるベース仮想アドレスを指します。このアドレスは、カーネルアドレス空間内のドライバーのコードセクションの先頭を表します。 I/O マネージャーは、ドライバーが読み込まれるときにこの値を設定します。

DriverSize

メモリ内のドライバーイメージのサイズをバイト単位で指定します。この値は、コード、データ、その他のセクションを含む、読み込まれたドライバーのメモリ占有領域の合計を表します。 I/O マネージャーは、ドライバーが読み込まれるときにこの値を設定します。

DriverSection

メモリマネージャーのドライバーイメージを表すドライバーのセクションオブジェクトをポイントします。これは、メモリマネージャーとローダーによって内部的に使用される不透明なシステム構造です。ドライバーは、このメンバーにアクセスしたり変更したりしないでください。

DriverExtension

ドライバー拡張機能へのポインター。ドライバー拡張機能の唯一のアクセス可能なメンバーは 、DriverExtension->AddDeviceです。ドライバーの DriverEntry ルーチンには、ドライバーの AddDevice ルーチンが格納されます。

DriverName

ドライバーの Unicode 文字列名を格納します。このフィールドは、エラーログスレッドによって、I/O 要求がバインドされているドライバーの名前を決定するために使用されます。これは通常、 \Driver\DriverName という形式で、 DriverName はレジストリ内のドライバーのサービス名に対応します。 I/O マネージャーは、ドライバーのレジストリ構成に基づいてこの値を設定します。

HardwareDatabase

レジストリ内のハードウェア構成情報への \Registry\Machine\Hardware パスへのポインター。

FastIoDispatch

ドライバーの高速 I/O エントリポイントを定義する FAST_IO_DISPATCH 構造体へのポインター。この省略可能なポインターは、"高速 I/O" サポート用のドライバーへの代替エントリポイントの配列を指します。高速 I/O は、標準の IRP 呼び出しメカニズムを使用するのではなく、個別のパラメーターを使用してドライバールーチンを直接呼び出すことによって実行されます。これらの関数は、同期 I/O およびファイルがキャッシュされる場合にのみ使用できます。このメンバーは、ファイルシステムドライバー (FSD) とネットワークトランスポートドライバーでのみ使用されます。

DriverInit

ドライバーの DriverEntry ルーチンのエントリポイントアドレス。 I/O マネージャーは、ドライバーが読み込まれるときに、ドライバーの初期化関数を指すこのフィールドを設定します。これは、メモリに読み込まれるときにドライバーで呼び出される最初の関数であり、ドライバーオブジェクトの初期化とディスパッチルーチンの設定を担当します。

DriverStartIo

ドライバーの StartIo ルーチンのエントリポイント (ある場合)、ドライバーの初期化時に DriverEntry ルーチンによって設定されます。ドライバーに StartIo ルーチンがない場合、このメンバーは NULL 。

DriverUnload

ドライバーのアンロードルーチンのエントリポイント (存在する場合)、ドライバーの初期化時に DriverEntry ルーチンによって設定されます。ドライバーに Unload ルーチンがない場合、このメンバーは NULL 。

MajorFunction[IRP_MJ_MAXIMUM_FUNCTION + 1]

ドライバーの DispatchXxx ルーチンのエントリポイントの配列で構成されるディスパッチテーブル。配列のインデックス値は、各 IRP メジャー関数コードを表す IRP_MJ_XXX 値です。このメジャー関数ディスパッチテーブルは、拡張可能なままになるように、オブジェクトの最後のフィールドである必要があります。各ドライバーは、ドライバーが処理する IRP_MJ_XXX 要求のエントリポイントをこの配列に設定する必要があります。詳細については、「ディスパッチルーチンの作成」を参照してください。

ドライバー、静的ドライバー検証ツール (SDV)、およびその他の検証ツールのコード分析をするために、次のコード例に示すように、各 DispatchXxx ルーチンはDRIVER_DISPATCH型を使用して宣言されます。

DRIVER_DISPATCH DispatchXxx;

その後、コールバックルーチンは次のように実装されます。

_Use_decl_annotations_
NTSTATUS
  DispatchXxx(
    struct _DEVICE_OBJECT  *DeviceObject,
    struct _IRP  *Irp
    )
  {
      // Function body
  }

DRIVER_DISPATCH関数の種類は、Wdm.h ヘッダーファイルで定義されています。コード分析ツールの実行時にエラーをより正確に識別するには、_Use_decl_annotations_ 注釈を関数定義に追加してください。 _Use_decl_annotations_ 注釈により、ヘッダーファイル内のDRIVER_DISPATCH関数型に適用される注釈が確実に使用されます。関数宣言の要件の詳細については、「WDM ドライバーのの関数の役割の種類を使用して関数を宣言するを参照してください。 _Use_decl_annotations_の詳細については、「関数の動作に注釈を付けるを参照してください。

備考

システムがドライバーを自動的に読み込むには、各カーネルモードドライバーの初期化ルーチンに DriverEntry という名前を付ける必要があります。このルーチンの名前が別の場合、ドライバーライターはリンカーの初期化ルーチンの名前を定義する必要があります。それ以外の場合、システムローダーまたは I/O マネージャーは、ドライバーの転送アドレスを見つけることができません。他の標準ドライバールーチンの名前は、ドライバーライターの裁量で選択できます。

ドライバーは、ドライバーが読み込まれるときに、DriverEntry ルーチンに渡されるドライバーオブジェクトの DispatchXxx エントリポイントを設定する必要があります。デバイスドライバーは、同じ種類のデバイスのドライバーが処理する必要がある IRP_MJ_XXX のエントリポイント 1 つ以上の DispatchXxx を設定する必要があります。上位レベルのドライバーは、基になるデバイスドライバーに渡す必要があるすべての IRP_MJ_XXX の 1 つ以上の DispatchXxx エントリポイントを設定する必要があります。それ以外の場合、ドライバーは、ドライバーオブジェクトに DispatchXxx ルーチンを設定しない IRP_MJ_XXX の IRP を送信されません。さまざまな種類の基になるデバイスのドライバーを処理する必要がある IRP_MJ_XXX のセットの詳細については、「IRP の主要な機能コードを参照してください。

DriverEntry ルーチンは、ドライバーオブジェクトにドライバーの AddDevice、StartIo、または Unload エントリポイント (存在する場合) を設定します。

HardwareDatabase 文字列は、ドライバーの読み込み時にデバイスドライバーがレジストリからハードウェア構成情報を取得するために使用できます。ドライバーには、この文字列への読み取り専用アクセス権が付与されます。

RegistryPathDriverEntry ルーチンへの入力は、driverName の値エントリがドライバーを識別する、\Registry\Machine\System\CurrentControlSet\Services\DriverName キー 指します。このレジストリキーには、次のような値を含むドライバーのサービス構成が含まれています。

スタート: ドライバーを読み込む必要がある場合 (ブート、システム、自動、需要、または無効)
型: サービスの種類 (カーネルドライバー、ファイルシステムドライバーなど)
ErrorControl: ドライバーの読み込みに失敗した場合のシステムの応答方法
ImagePath: ドライバーバイナリファイルへのパス

ドライバーは、サービスキーの Parameters サブキーの下に追加の構成データを格納できます。入力ドライバーオブジェクトの HardwareDatabase に関しては、ドライバーには、この文字列への読み取り専用アクセス権が与えられています。

ドライバーオブジェクト内の文書化されていないメンバーは、アクセス不可と見なす必要があります。オブジェクトメンバーの場所または文書化されていないメンバーへのアクセスに依存するドライバーは、移植性が維持されず、時間の経過と共に他のドライバーと相互運用できない可能性があります。

必要条件

要件	価値
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

次の方法で共有

DRIVER_OBJECT構造体 (wdm.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース