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 |