WdfFileObjectGetDevice 関数 (wdffileobject.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfFileObjectGetDevice メソッドは、指定されたフレームワーク ファイル オブジェクトに関連付けられているフレームワーク デバイス オブジェクトを返します。

構文

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

パラメーター

[in] FileObject

フレームワーク ファイル オブジェクトへのハンドル。

戻り値

WdfFileObjectGetDevice は、指定されたフレームワーク ファイル オブジェクトに関連付けられているフレームワーク デバイス オブジェクトへのハンドルを返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

フレームワーク ファイル オブジェクトの詳細については、「 フレームワーク ファイル オブジェクト」を参照してください。

例

次のコード例は、 EvtFileClose コールバック関数が、指定したフレームワーク ファイル オブジェクトに関連付けられているフレームワーク デバイス オブジェクトを取得する方法を示しています。

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdffileobject.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)