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)