WdfFileObjectWdmGetFileObject 函式 (wdffileobject.h)

[僅適用於 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);

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdffileobject.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

FILE_OBJECT