DEVICE_OBJECT 構造体 (wdm.h)

[アーティクル]
02/09/2024

DEVICE_OBJECT構造体は、オペレーティングシステムによってデバイスオブジェクトを表すために使用されます。デバイスオブジェクトは、ドライバーが I/O 要求を処理する論理、仮想、または物理デバイスを表します。

構文

typedef struct _DEVICE_OBJECT {
  CSHORT                   Type;
  USHORT                   Size;
  LONG                     ReferenceCount;
  struct _DRIVER_OBJECT    *DriverObject;
  struct _DEVICE_OBJECT    *NextDevice;
  struct _DEVICE_OBJECT    *AttachedDevice;
  struct _IRP              *CurrentIrp;
  PIO_TIMER                Timer;
  ULONG                    Flags;
  ULONG                    Characteristics;
  __volatile PVPB          Vpb;
  PVOID                    DeviceExtension;
  DEVICE_TYPE              DeviceType;
  CCHAR                    StackSize;
  union {
    LIST_ENTRY         ListEntry;
    WAIT_CONTEXT_BLOCK Wcb;
  } Queue;
  ULONG                    AlignmentRequirement;
  KDEVICE_QUEUE            DeviceQueue;
  KDPC                     Dpc;
  ULONG                    ActiveThreadCount;
  PSECURITY_DESCRIPTOR     SecurityDescriptor;
  KEVENT                   DeviceLock;
  USHORT                   SectorSize;
  USHORT                   Spare1;
  struct _DEVOBJ_EXTENSION *DeviceObjectExtension;
  PVOID                    Reserved;
} DEVICE_OBJECT, *PDEVICE_OBJECT;

メンバー

Type

オブジェクトがデバイスオブジェクトであることを示すためにオペレーティングシステムによって使用されます。デバイスオブジェクトの場合、このメンバーの値は 3 です。これは読み取り専用メンバーです。

Size

デバイスオブジェクトのサイズをバイト単位で指定します。このサイズには、 DeviceExtension メンバーが指すドライバー指定のデバイス拡張機能が含まれますが、 DeviceObjectExtension メンバーが指す不透明なデバイスオブジェクト拡張機能は含まれません。 Size は読み取り専用メンバーです。

ReferenceCount

I/O マネージャーが、デバイスオブジェクトに関連付けられているデバイスの開いているハンドルの数を追跡するために使用されます。これにより、I/O マネージャーは、ドライバーのデバイスの未処理のハンドルがある場合にドライバーのアンロードを回避できます。これは読み取り専用メンバーです。

DriverObject

DriverEntry ルーチンと AddDevice ルーチンに入力されたドライバーの読み込まれたイメージを表すドライバーオブジェクト (DRIVER_OBJECT) へのポインター。このメンバーは、IoCreateDevice または IoCreateDeviceSecure の呼び出しが正常に行われると、I/O マネージャーによって設定されます。これは読み取り専用メンバーです。

NextDevice

同じドライバーによって作成された次のデバイスオブジェクト (存在する場合) へのポインター。 I/O マネージャーは、 IoCreateDevice または IoCreateDeviceSecure の呼び出しが成功するたびに、このリストを更新します。

アンロードされている非プラグアンドプレイ (PnP) ドライバーは、そのデバイスオブジェクトの一覧を走査 ("ウォーク") して削除する必要があります。 PnP ドライバーでは、このデバイスオブジェクトの一覧を確認する必要はありません。代わりに、PnP ドライバーは、デバイスの削除 PnP 操作中にクリーンアップを実行します (IRP_MN_REMOVE_DEVICE)。

デバイスオブジェクトを動的に再作成するドライバーも、このメンバーを使用します。これは、読み取り/書き込みメンバーです。

AttachedDevice

アタッチされたデバイスオブジェクトへのポインター。アタッチされたデバイスオブジェクトがない場合、このメンバーは NULL です。 AttachedDevice メンバーによって指されるデバイスオブジェクトは、通常、フィルタードライバーのデバイスオブジェクトです。このオブジェクトは、デバイスオブジェクトによって表されるデバイスを最初に対象とした I/O 要求をインターセプトします。詳細については、「 IoAttachDevice」および「IoAttachDeviceByPointer 」トピックを参照してください。これは不透明なメンバーです。

CurrentIrp

ドライバーに StartIo ルーチンがあり、そのエントリポイントがドライバーオブジェクトに設定されていて、ドライバーが現在 IRP を処理している場合は、現在の IRP へのポインター。それ以外の場合、このメンバーは NULL です。詳細については、「 IoStartPacket 」および「IoStartNextPacket 」トピックを参照してください。これは読み取り専用メンバーです。

Timer

タイマーオブジェクトへのポインター。これにより、I/O マネージャーは 1 秒ごとにドライバー指定のタイマールーチンを呼び出すことができます。詳細については、「 IoInitializeTimer」を参照してください。これは、読み取り/書き込みメンバーです。

Flags

デバイスドライバーは、次のシステム定義値の 1 つ以上を使用して、新しく作成されたデバイスオブジェクトでこのメンバーに対してビットごとの OR 操作を実行します。

Flags メンバーを設定する方法の詳細については、「デバイスオブジェクトの初期化」を参照してください。

値	意味
DO_VERIFY_VOLUME (0x00000002)	リムーバブルメディアドライバーは、転送要求の処理中にこのフラグを設定します。このようなドライバーは、データを転送する前に、転送要求のターゲットでこのフラグをチェックする必要もあります。詳細については、「リムーバブルメディアのサポート」トピックを参照してください。
DO_BUFFERED_IO (0x00000004)	デバイススタックに送信される I/O 要求に対して I/O マネージャーによって使用されるバッファリングの種類を指定します。上位レベルのドライバーまたはスタック内の次の下位ドライバーと同じ値を持つこのメンバー (最上位レベルのドライバーの場合を除く)。
DO_EXCLUSIVE (0x00000008)	ドライバーがビデオ、シリアル、並列、サウンドデバイスなどの排他的なデバイスを提供することを示します。 WDM ドライバーは、このフラグを設定できません。詳細については、「デバイスオブジェクトへの排他アクセスの指定」トピックを参照してください。
DO_DIRECT_IO (0x00000010)	「DO_BUFFERED_IO」を参照してください。
DO_MAP_IO_BUFFER (0x00000020)	このフラグは使用されなくなりました。ドライバーは、このフラグを設定しないでください。
DO_DEVICE_INITIALIZING (0x00000080)	I/O マネージャーは、デバイスオブジェクトを作成するときにこのフラグを設定します。デバイス関数ドライバーまたはフィルタードライバーは、(1) デバイスオブジェクトをデバイススタックにアタッチした後、 AddDevice ルーチンのフラグをクリアします。 (2) デバイスの電源状態を確立します。 (3) いずれかの電源フラグを持つメンバーに対してビットごとの OR 操作を実行します (必要な場合)。プラグアンドプレイ (PnP) マネージャーは、AddDevice ルーチンが返された後にフラグがクリアされていることを確認します。
DO_SHUTDOWN_REGISTERED (0x00000800)	ドライバーがシャットダウン通知用にデバイスオブジェクトを登録したことを示すために、I/O マネージャーによって使用されます。このフラグはドライバーで使用しないでください。
DO_BUS_ENUMERATED_DEVICE (0x00001000)	オペレーティングシステムは、各物理デバイスオブジェクト (PDO) でこのフラグを設定します。ドライバーは、このフラグを変更しないでください。
DO_POWER_PAGABLE (0x00002000)	Microsoft Windows 2000 以降のバージョンの Windows と互換性のあるページング可能なドライバーは、ページングパスの一部ではなく、突入電流を必要としない場合は、このフラグを設定する必要があります。システムは、IRQL = PASSIVE_LEVELでこのようなドライバーを呼び出します。ドライバーは、このフラグとDO_POWER_INRUSHの両方を設定できません。 WDM、Microsoft Windows 98、および Windows Millennium Edition のすべてのドライバーは、DO_POWER_PAGABLE設定する必要があります。
DO_POWER_INRUSH (0x00004000)	デバイスがオンになっているときに突入電流を必要とするデバイスのドライバーは、このフラグを設定する必要があります。ドライバーは、このフラグとDO_POWER_PAGABLEの両方を設定できません。
DO_DEVICE_TO_BE_RESET (0x04000000)	I/O マネージャーは、このフラグをバスドライバーがデバイスをリセットするための信号として設定します。他のドライバーでは、このフラグを使用しないでください。
DO_DAX_VOLUME (0x10000000)	ボリュームが DAX ボリュームであることを示します。

Characteristics

ドライバーのデバイスに関する追加情報を提供する 1 つ以上のシステム定義定数を、ビットごとの OR 操作と組み合わせて指定します。これらの定数には、次のものが含まれます。

値	意味
FILE_AUTOGENERATED_DEVICE_NAME	このルーチンを呼び出すときに DeviceName を指定する呼び出し元ではなく、デバイスの名前を生成するように I/O マネージャーに指示します。 I/O マネージャーは、名前が一意であることを確認します。通常、この特性は PnP バスドライバーによって指定され、同じバス上の子デバイスの物理デバイスオブジェクト (PDO) の名前を生成します。
FILE_CHARACTERISTIC_PNP_DEVICE	デバイスオブジェクトがプラグアンドプレイ (PnP) スタックの一部であることを示します。この特性は、バスドライバー (またはバスフィルタードライバー) が、IRP_MN_START_DEVICE要求をまだ受信していないデバイスオブジェクトの WMI サポートを登録する場合に必要です。 FILE_CHARACTERISTIC_PNP_DEVICEは、関数またはフィルタードライバーがそのデバイススタックに接続する前に WMI に登録されている場合にも必要です。
FILE_CHARACTERISTIC_TS_DEVICE	デバイスオブジェクトがターミナルサービスデバイススタックの一部であることを示します。ドライバーでは、この特性を設定しないでください。
FILE_CHARACTERISTIC_WEBDAV_DEVICE	Web ベースの分散作成およびバージョン管理 (WebDAV) ファイルシステムがデバイスにマウントされていることを示します。ドライバーでは、この特性を設定しないでください。
FILE_DEVICE_IS_MOUNTED	ファイルシステムがデバイスにマウントされていることを示します。ドライバーでは、この特性を設定しないでください。
FILE_DEVICE_SECURE_OPEN	I/O マネージャーに、デバイスオブジェクトのセキュリティ記述子を、デバイスの相対オープンと末尾のファイル名のオープンに適用するように指示します。詳細については、デバイス名前空間アクセスの制御に関するトピックを参照してください。
FILE_FLOPPY_DISKETTE	デバイスがフロッピーディスクデバイスであることを示します。
FILE_READ_ONLY_DEVICE	デバイスを書き込むことができないことを示します。
FILE_REMOTE_DEVICE	デバイスがリモートであることを示します。
FILE_REMOVABLE_MEDIA	ストレージデバイスがリムーバブルメディアをサポートしていることを示します。この特性は、リムーバブルデバイスではなく、リムーバブルメディアを示していることに注意してください。たとえば、JAZ ドライブデバイスのドライバーではこの特性を指定する必要がありますが、PCMCIA フラッシュディスクのドライバーは指定しないでください。
FILE_VIRTUAL_VOLUME	ボリュームが仮想であることを示します。ドライバーでは、この特性を設定しないでください。
FILE_WRITE_ONCE_MEDIA	デバイスが書き込み 1 回のメディアをサポートしていることを示します。ドライバーは、このメンバーを直接設定しません。デバイスの特性を設定する方法の詳細については、「デバイス特性の指定」トピックを参照してください。
FILE_CHARACTERISTIC_CSV	デバイスがクラスター共有ボリューム (CSV) であることを示します。
FILE_DEVICE_ALLOW_APPCONTAINER_TRAVERSAL	IO マネージャーは通常、クライアントがアプリコンテナーである場合に開くすべてのファイルに対してスキャンアクセスに対して完全なセキュリティチェックを実行します。クライアントトークンにスキャン特権が既に存在する場合、このフラグを設定すると、この強制走査アクセスチェックがバイパスされます。
FILE_PORTABLE_DEVICE	基になるスタックがデバイスを移植可能と見なしていることを示します。これはストレージスタックによって使用され、デバイスがローカルコンピューターコンテナー内になく、固定バスの種類ではないことを意味します。

Vpb

デバイスオブジェクトに関連付けられているボリュームパラメーターブロック (VPB) へのポインター。ファイルシステムドライバーの場合、VPB は、マウントされたボリュームのインスタンスを表す名前のない論理デバイスオブジェクトへの接続を提供できます。これは不透明なメンバーです。

DeviceExtension

デバイス拡張機能へのポインター。デバイス拡張機能の構造と内容は、ドライバーによって定義されます。サイズはドライバーによって決定され、IoCreateDevice または IoCreateDeviceSecure へのドライバーの呼び出しで指定されます。デバイス拡張機能の詳細については、「デバイス拡張機能」を参照してください。これは読み取り専用メンバーです。ただし、メンバーが指すオブジェクトは、ドライバーによって変更できます。

DeviceType

そのルーチンのDeviceType パラメーターに指定された値を使用して、IoCreateDevice と IoCreateDeviceSecure によって設定されます。詳細については、「デバイスの種類の指定」トピックを参照してください。

StackSize

このドライバーに送信される IRP 内のスタックの場所の最小数を指定します。 IoCreateDevice と IoCreateDeviceSecure は、新しく作成されたデバイスオブジェクトでこのメンバーを 1 に設定します。したがって、最下位レベルのドライバーは、このメンバーを無視できます。ドライバーが IoAttachDevice または IoAttachDeviceToDeviceStack を呼び出す場合、I/O マネージャーは、上位レベルのドライバーのデバイスオブジェクトの StackSize メンバーを適切な値に自動的に設定します。 IoGetDeviceObjectPointer を使用して別のドライバーにチェーンする上位レベルのドライバーのみが、独自のデバイスオブジェクトの StackSize の値を 1 + 次の下位ドライバーのデバイスオブジェクトの StackSize 値に明示的に設定する必要があります。

Queue

I/O マネージャーによって内部的に使用され、必要に応じてデバイスオブジェクトをキューに入れます。これは不透明なメンバーです。

Queue.ListEntry

2 重リンクリストの前方ポインターと下位ポインターを含むLIST_ENTRY構造体。

Queue.Wcb

I/O マネージャーで使用されるデバイスコンテキスト情報。

AlignmentRequirement

データ転送のデバイスのアドレスアラインメント要件を指定します。値は、Wdm.h で定義されているFILE_XXX_ALIGNMENT 値のいずれかである必要があります。詳細については、「デバイスオブジェクトの初期化」、「 GetDmaAlignment」、「 ZwQueryInformationFile」トピックを参照してください。

DeviceQueue

デバイスオブジェクトのデバイスキューオブジェクト。デバイスキューオブジェクトには、デバイスオブジェクトに関連付けられているドライバーによる処理を待機している IRP が含まれています。詳細については、「 Driver-Managed IRP Queues 」トピックを参照してください。これは不透明なメンバーです。

Dpc

デバイスオブジェクトの遅延プロシージャ呼び出し (DPC) オブジェクト。詳細については、「 DPC オブジェクトの概要」トピックを参照してください。これは不透明なメンバーです。

ActiveThreadCount

将来利用するために予約されています。これは不透明なメンバーです。

SecurityDescriptor

デバイスオブジェクトの作成時に、デバイスオブジェクトのセキュリティ記述子 (SECURITY_DESCRIPTOR) を指定します。このメンバーが NULL の場合、デバイスオブジェクトは既定のセキュリティ設定を受け取ります。これは読み取り専用のメンバーですが、メンバーは ZwSetSecurityObject 関数を使用して変更できます。

DeviceLock

I/O マネージャーによって割り当てられる同期イベントオブジェクト。 I/O マネージャーは、マウントまたはマウント検証要求をファイルシステムドライバーにディスパッチする前に、イベントオブジェクトを取得します。これは不透明なメンバーです。

SectorSize

デバイスオブジェクトがボリュームを表していない場合、このメンバーは 0 に設定されます。デバイスオブジェクトがボリュームを表す場合、このメンバーはボリュームのセクターサイズをバイト単位で指定します。 I/O マネージャーは、このメンバーを使用して、中間バッファリングが無効になっているときに発行されるすべての読み取り操作、書き込み操作、およびファイル位置の設定操作が正しくアラインされていることを確認します。ただし、デバイスオブジェクトが作成されるときに、セクターごとの既定のシステムバイト数の値が使用されます。ただし、ファイルシステムドライバー。さらにまれに、レガシドライバーとミニフィルタードライバーでは、マウントが発生したときに基になるボリュームハードウェアのジオメトリに基づいてこの値を更新できます。他のドライバーでは、このメンバーを変更しないでください。

Spare1

システムで使用するために予約されています。これは不透明なメンバーです。

DeviceObjectExtension

デバイスの状態に関する情報を格納するために I/O マネージャーと PnP マネージャーによって使用されるデバイスオブジェクト拡張機能へのポインター。これは不透明なメンバーです。

Reserved

システムで使用するために予約されています。これは不透明なメンバーです。

注釈

オペレーティングシステムは、デバイスオブジェクト別のデバイスを表します。詳細については、「デバイスオブジェクトとデバイススタック」トピックを参照してください。

ドライバーは、 IoCreateDevice ルーチンと IoCreateDeviceSecure ルーチンを使用してデバイスオブジェクトを作成します。デバイスオブジェクトを作成する方法の詳細については、「デバイスオブジェクトの作成」を参照してください。

デバイスオブジェクトは部分的に不透明です。ドライバーは、特に記載されていない限り、デバイスオブジェクトのメンバーを直接設定しません。ドライバーが直接変更できるメンバーの詳細については、「デバイスオブジェクトの初期化」を参照してください。その他のデバイスオブジェクトのプロパティについては、「デバイスオブジェクトのプロパティ」を参照してください。

デバイスオブジェクト内の不透明なメンバーは、アクセスできないと見なす必要があります。オブジェクトメンバーの場所に依存しているドライバーや、不透明なメンバーへのアクセスを持つドライバーは、移植可能で、時間の経過と共に他のドライバーと相互運用できない可能性があります。

システム提供のビデオポートドライバーは、ビデオミニポートドライバーの代わりに作成するデバイスオブジェクトのフィールドを設定します。

システム提供の SCSI ポートドライバーは、 SCSI ミニポートドライバーの代わりに作成するデバイスオブジェクトのフィールドを設定します。

システム提供の NDIS ライブラリは、 NDIS ミニポートドライバーの代わりに作成するデバイスオブジェクトのフィールドを設定します。

要件

要件	値
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h、Fltkernel.h を含む)

DEVICE_OBJECT 構造体 (wdm.h)

構文

メンバー

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース