WdfWmiInstanceFireEvent 函式 (wdfwmi.h)

  • 發行項

[僅適用於 KMDF]

WdfWmiInstanceFireEvent 方法會將 WMI 事件傳送至已註冊以接收事件通知的 WMI 用戶端。

語法

NTSTATUS WdfWmiInstanceFireEvent(
  [in]           WDFWMIINSTANCE WmiInstance,
  [in, optional] ULONG          EventDataSize,
  [in, optional] PVOID          EventData
);

參數

[in] WmiInstance

驅動程式從先前呼叫 WdfWmiInstanceCreate 取得的 WMI 實例物件的句柄。

[in, optional] EventDataSize

EventData 指向的事件數據大小，以位元組為單位。

[in, optional] EventData

事件數據的指標，如果沒有事件數據，則為 NULL 。

傳回值

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

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES
 記憶體不足。
STATUS_UNSUCCESSFUL
 架構嘗試與 WMI 通訊失敗。
STATUS_BUFFER_OVERFLOW
 事件數據緩衝區太大。
 

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

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

備註

只有當 WMI 用戶端已註冊事件通知時，您的驅動程式才應該呼叫 WdfWmiInstanceFireEvent 。 驅動程式可以提供 EvtWmiProviderFunctionControl 回調函式或呼叫 WdfWmiProviderIsEnabled 來判斷它是否應該呼叫 WdfWmiInstanceFireEvent。

如果有任何事件特定數據，驅動程序應該放在 EventData 參數指向的緩衝區中。 架構會新增所有必要的 WMI 標頭資訊。

如需 WdfWmiInstanceFireEvent 方法的詳細資訊，請參閱 在 Framework-Based Drivers 中支援 WMI。

範例

下列程式代碼範例會將 WMI 事件傳送至 WMI 用戶端。

MY_WMI_EVENT_DATA eventData;
NTSTATUS  status;

status = WdfWmiInstanceFireEvent(
                                 WmiInstance,
                                 sizeof(eventData),
                                 (PVOID)&eventData
                                 );

規格需求

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

另請參閱

EvtWmiProviderFunctionControl

WdfWmiInstanceCreate

WdfWmiProviderIsEnabled