WdfFileObjectWdmGetFileObject 関数 (wdffileobject.h)
[KMDF にのみ適用]
WdfFileObjectWdmGetFileObject メソッドは、指定されたフレームワーク ファイル オブジェクトに関連付けられている Windows ドライバー モデル (WDM) ファイル オブジェクトを返します。
構文
PFILE_OBJECT WdfFileObjectWdmGetFileObject(
[in] WDFFILEOBJECT FileObject
);
パラメーター
[in] FileObject
フレームワーク ファイル オブジェクトへのハンドル。
戻り値
WdfFileObjectWdmGetFileObject は、指定したフレームワーク ファイル オブジェクトに関連付けられている FILE_OBJECT 構造体へのポインターを返します。指定したフレームワーク ファイル オブジェクトに WDM ファイル オブジェクトがない場合は NULL を 返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
WdfFileObjectWdmGetFileObject メソッドが返すポインターは、フレームワーク ファイル オブジェクトが削除されるまで有効です。 ドライバーがフレームワーク ファイル オブジェクトの EvtCleanupCallback 関数を提供する場合、ポインターはコールバック関数が返されるまで有効です。
フレームワーク ファイル オブジェクトの詳細については、「 フレームワーク ファイル オブジェクト」を参照してください。
例
次のコード例では、指定したフレームワーク ファイル オブジェクトに関連付けられている WDM ファイル オブジェクトへのハンドルを取得します。
PFILE_OBJECT pReturnedFileObject;
pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| Header | wdffileobject.h (Wdf.h を含む) |
| Library | Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。 |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |