WdfDriverWdmGetDriverObject 函式 (wdfdriver.h)

  • 發行項

[僅適用於 KMDF]

WdfDriverWdmGetDriverObject 方法會擷取與指定架構驅動程式對象相關聯的 Windows 驅動程式模型指標 (WDM) 驅動程序物件。

語法

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

參數

[in] Driver

驅動程式架構驅動程序物件的句柄，該驅動程式是從先前呼叫 WdfDriverCreate 或 WdfGetDriver 取得的。

傳回值

WdfDriverWdmGetDriverObject 會傳回 DRIVER_OBJECT 結構的指標。 如果 驅動程式 句柄無效，就會發生系統錯誤檢查。

備註

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

範例

下列程式代碼範例會取得與指定之架構驅動程式對象相關聯的 WDM 驅動程式物件的指標。

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

規格需求

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

另請參閱

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver