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 回呼函式,您的驅動程式必須先將函式的位址放在 WDF_WMI_INSTANCE_CONFIG 結構中,才能呼叫 WdfWmiInstanceCreate。
架構不會同步處理驅動程式 WMI 事件回呼函式的呼叫彼此或驅動程式的其他事件回呼函式。 如果 EvtWmiInstanceSetInstance 回呼函式的數據是動態的,並與其他回呼函式共用,則驅動程式可以使用架構的 等候鎖定或微調鎖定, 同步存取數據。
如需 EvtWmiInstanceSetInstance 回呼函式的詳細資訊,請參閱 Framework-Based Drivers中支援 WMI。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
標頭 | wdfwmi.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |