IoGetDiskDeviceObject 関数 (ntifs.h)

[アーティクル]
03/05/2024

IoGetDiskDeviceObject ルーチンは、特定のファイルシステムボリュームデバイスオブジェクトに関連付けられているディスクデバイスオブジェクトへのポインターを取得します。

構文

NTSTATUS IoGetDiskDeviceObject(
  [in] PDEVICE_OBJECT FileSystemDeviceObject,
       PDEVICE_OBJECT *DiskDeviceObject
);

パラメーター

[in] FileSystemDeviceObject

ファイルシステムデバイスオブジェクトへのポインター。

DiskDeviceObject

ディスクデバイスオブジェクトのデバイスオブジェクトのアドレスを受け取る変数へのポインター。

戻り値

IoGetDiskDeviceObject は 、次のいずれかの状態値を返します。

リターンコード	説明
STATUS_INVALID_PARAMETER	この関数に渡されたパラメーターの 1 つが無効でした。
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

注釈

IoGetDiskDeviceObject は、ファイルシステムボリュームに関連付けられているストレージデバイスオブジェクトへのポインターを返します。ストレージデバイスは実際のディスクである必要はありません

通常、ファイルシステムフィルタードライバーは、ファイルシステムボリュームデバイスオブジェクトの IoGetDiskDeviceObject を呼び出して、ボリュームがマウントされているかどうかを判断します。

IoGetDiskDeviceObject は、 DeviceObject が指すディスクデバイスオブジェクトの参照カウントをインクリメントします。したがって、 IoGetDiskDeviceObject の呼び出しが成功するたびに、 ObDereferenceObject の後続の呼び出しと一致する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 SP4 更新プログラムのロールアップ。Windows XP
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL