EVT_WDF_WMI_INSTANCE_SET_INSTANCE回呼函式 (wdfwmi.h)

[僅適用于 KMDF]

驅動程式的 EvtWmiInstanceSetInstance 回 呼函式會將 WMI 資料提供者的所有實例資料設定為 WMI 用戶端提供的值。

語法

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

NTSTATUS EvtWdfWmiInstanceSetInstance(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

參數

[in] WmiInstance

WMI 實例物件的控制碼。

[in] InBufferSize

InBuffer所指向之輸入緩衝區的大小,以位元組為單位。

[in] InBuffer

輸入緩衝區的指標。

傳回值

如果作業成功, EvtWmiInstanceSetInstance 回 呼函式必須傳回STATUS_SUCCESS。 否則,此函式必須傳回狀態值, NT_SUCCESS (狀態) 等於 FALSE。 如果 InBuffer 參數指向的輸入緩衝區太小而無法包含驅動程式預期的所有資料,回呼函式必須傳回STATUS_WMI_SET_FAILURE。

備註

若要註冊EvtWmiInstanceSetInstance 回呼函式,您的驅動程式必須在呼叫WdfWmiInstanceCreate之前,將函式的位址放在WDF_WMI_INSTANCE_CONFIG結構中。

架構不會同步處理驅動程式 WMI 事件回呼函式的呼叫彼此,或與任何驅動程式的其他事件回呼函式同步處理。 如果 EvtWmiInstanceSetInstance 回呼函式的資料是動態的,並與其他回呼函式共用,則驅動程式可以使用架構的 等候鎖定或微調鎖定 來同步存取資料。

如需 EvtWmiInstanceSetInstance 回呼函式的詳細資訊,請參閱 在 Framework-Based Drivers 中支援 WMI

規格需求

   
目標平臺 環球
最低 KMDF 版本 1.0
標頭 wdfwmi.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate