WMI_SET_DATABLOCK_CALLBACK回呼函式 (wmilib.h)

  • 發行項

DpWmiSetDataBlock 例程會變更單一數據區塊實例中的所有數據項。 此例程是選擇性的。

語法

WMI_SET_DATABLOCK_CALLBACK WmiSetDatablockCallback;

NTSTATUS WmiSetDatablockCallback(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PIRP Irp,
  [in] ULONG GuidIndex,
  [in] ULONG InstanceIndex,
  [in] ULONG BufferSize,
  [in] PUCHAR Buffer
)
{...}

參數

[in] DeviceObject

驅動程式的 WDM DEVICE_OBJECT 結構的指標。

[in] Irp

IRP 的指標。

[in] GuidIndex

將數據區塊以零起始的索引指定至驅動程式在傳遞至 WmiSystemControl 的 WMILIB_CONTEXT 結構中提供的 GUID 清單。

[in] InstanceIndex

如果 GuidIndex 指定的區塊有多個實例， InstanceIndex 會指定 實例。

[in] BufferSize

指定 緩衝區的位元組大小。

[in] Buffer

緩衝區的指標，其中包含 實例的新值。

傳回值

DpWmiSetDataBlock 會傳回STATUS_SUCCESS或適當的錯誤狀態，例如：

如果驅動程式無法立即完成要求，它可以傳回STATUS_PENDING。

備註

WMI 會在驅動程式呼叫 WmiSystemControl 以回應IRP_MN_CHANGE_SINGLE_INSTANCE要求之後呼叫驅動程式的 DpWmiSetDataBlock 例程。

驅動程式負責驗證所有輸入自變數。 具體而言，驅動程式必須執行下列動作：

  • 根據 WMILIB_CONTEXT 結構的 GuidCount 成員，確認 GuidIndex 值介於零和 GuidCount-1 之間。
  • 確認驅動程式尚未標示要移除的指定數據區塊。 如果驅動程式最近在包含在WMILIB_CONTEXT 結構中的 WMIGUIDREGINFO 結構中指定WMIREG_FLAG_REMOVE_GUID旗標，在移除發生之前，可能會有設定的要求抵達。
  • 確認 InstanceIndex 值位於數據區塊驅動程式支援的實例索引範圍內。
  • 確認 Buffer 和 BufferSize 描述有效的大小數據區塊，包括數據項之間存在的任何填補，以及緩衝區的內容對數據區塊有效。
  • 確認指定的數據區塊是驅動程式允許呼叫端起始的修改之一。 換句話說，驅動程式不應該允許修改您想要只讀的數據區塊。
請勿假設線程內容是起始使用者模式應用程式的線程內容，較高層級的驅動程式可能已經變更它。

如果驅動程式實作 DpWmiSetDataBlock 例程，驅動程式必須將例程的位址放在傳遞給 WmiSystemControl 之WMILIB_CONTEXT結構的 SetWmiDataBlock 成員中。 如果驅動程式未實作 DpWmiSetDataBlock 例程，則必須 將 SetWmiDataBlock 設定為 NULL。 在後者的情況下，WMI 會將STATUS_READ_ONLY傳回給呼叫端。

這個例程可以是可分頁的。

如需實作此例程的詳細資訊，請參閱 呼叫 WmiSystemControl 來處理 WMI IRP。

規格需求

需求 值
目標平台 桌面
標頭 wmilib.h (包含 Wmilib.h)
IRQL 在 PASSIVE_LEVEL呼叫。

另請參閱

IRP_MN_CHANGE_SINGLE_INSTANCE

WMILIB_CONTEXT

WmiSystemControl