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)

こちらもご覧ください

FILE_OBJECT