共用方式為


WdfFileObjectWdmGetFileObject 函式 (wdffileobject.h)

[僅適用於 KMDF]

WdfFileObjectWdmGetFileObject 方法會傳回與指定架構檔案對象相關聯的 Windows 驅動程式模型 (WDM) 檔案物件。

語法

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

參數

[in] FileObject

架構檔案物件的句柄。

返回值

WdfFileObjectWdmGetFileObject 會傳回與指定之架構檔案對象相關聯的 FILE_OBJECT 結構的指標,如果指定的架構檔案對象沒有 WDM 檔案物件,則 NULL

如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。

備註

WdfFileObjectWdmGetFileObject 方法傳回的指標有效,直到刪除架構檔案對象為止。 如果驅動程式為架構檔案物件提供 EvtCleanupCallback 函式,則指標會有效,直到回呼函式傳回為止。

如需架構檔案物件的詳細資訊,請參閱 Framework File Objects

範例

下列程式代碼範例會取得與指定架構檔案對象相關聯的 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)

另請參閱

FILE_OBJECT