共用方式為

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。 否則，此方法可能會傳回下列其中一個值：

傳回碼 描述
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
                                 );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfwmi.h （包括 Wdf.h）
連結庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <= APC_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

EvtWmiProviderFunctionControl

WdfWmiInstanceCreate

WdfWmiProviderIsEnabled