WdfWmiInstanceRegister 函式 (wdfwmi.h)

[僅適用于 KMDF]

WdfWmiInstanceRegister方法會向系統的 WMI 服務註冊 WMI 資料提供者的指定實例。

語法

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

參數

[in] WmiInstance

驅動程式從先前呼叫 WdfWmiInstanceCreate 取得的 WMI實例物件的控制碼。

傳回值

如果作業成功,WdfWmiInstanceRegister會傳回STATUS_SUCCESS。 否則,這個方法可能會傳回下列其中一個值:

傳回碼 描述
STATUS_INVALID_DEVICE_REQUEST
指定的 WMI 實例已註冊。
 

這個方法也可能傳回其他 NTSTATUS 值

如果驅動程式提供不正確物件控制碼,就會發生錯誤檢查。

備註

提供者實例在註冊之前無法供 WMI 用戶端使用。 您的驅動程式必須呼叫WdfWmiInstanceRegister,或將實例WDF_WMI_INSTANCE_CONFIG結構的Register成員設定為TRUE

如需 WdfWmiInstanceRegister 方法的詳細資訊,請參閱 註冊提供者實例。 如需 WMI 的詳細資訊,請參閱 在 Framework-Based 驅動程式中支援 WMI

WdfWmiInstanceRegister 會同步登錄提供者實例, (也就是說,如果在 IRQL = PASSIVE_LEVEL呼叫提供者實例,則傳回) ,並在 IRQL > PASSIVE_LEVEL呼叫它時以非同步方式呼叫。

範例

下列程式碼範例會向系統的 WMI 服務註冊 WMI 資料提供者的指定實例。

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

必要條件

   
目標平臺 環球
最低 KMDF 版本 1.0
標頭 wdfwmi.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister