共用方式為


EVT_WDF_WMI_INSTANCE_SET_ITEM回呼函式 (wdfwmi.h)

[僅適用於 KMDF]

驅動程式的 EvtWmiInstanceSetItem 回呼函式會將 WMI 數據提供者實例數據的單一專案設定為 WMI 用戶端所提供的值。

語法

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

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

參數

[in] WmiInstance

WMI 實例物件的句柄。

[in] DataItemId

值,識別提供者實例的數據項。 這個值會對應至提供者MOF檔案中指定的 WmiDataId 值。

[in] InBufferSize

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

[in] InBuffer

輸入緩衝區的指標。

傳回值

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

備註

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

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

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

規格需求

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

另請參閱

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate