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