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 驅動程式中的支援 WMI。

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfwmi.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL

另請參閱

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate