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) |