IRP_MN_CHANGE_SINGLE_INSTANCE
所有支援 WMI 的驅動程式都必須處理此 IRP。 驅動程式可以呼叫 WmiSystemControl 或處理 IRP 本身來處理 WMI IRP，如 處理 WMI 要求中所述。
如果驅動程式呼叫 WmiSystemControl 來處理 IRP_MN_CHANGE_SINGLE_INSTANCE 要求，WMI 接著會呼叫該驅動程式的 DpWmiSetDataBlock 常式。
主要程式碼
傳送時
WMI 會傳送此 IRP 來變更單一資料區塊實例中的所有資料項目。
WMI 會在 IRQL = PASSIVE_LEVEL任意執行緒內容中傳送此 IRP。
輸入參數
Parameters.WMI.ProviderId 指向應回應要求的驅動程式裝置物件。 此指標可在 IRP 的驅動程式 I/O 堆疊位置中找到。
Parameters.WMI.DataPath 指向 GUID，識別與要變更之實例相關聯的資料區塊。
Parameters.WMI.BufferSize 指出 Parameters.WMI.Buffer的非分頁緩衝區大小。
Parameters.WMI.Buffer 指向可識別實例並指定新資料值的 WNODE_SINGLE_INSTANCE 結構。
輸出參數
無。
I/O 狀態欄塊
如果驅動程式藉由呼叫 WmiSystemControl來處理 IRP，WMI 會在 I/O 狀態欄塊中設定 Irp-IoStatus.Status > 和 Irp-IoStatus.Information > 。
否則，驅動程式會將 Irp-IoStatus.Status > 設定為STATUS_SUCCESS或適當的錯誤狀態，例如：
STATUS_WMI_INSTANCE_NOT_FOUND
STATUS_WMI_GUID_NOT_FOUND
STATUS_WMI_READ_ONLY
STATUS_WMI_SET_FAILURE
成功時，驅動程式會將 Irp-IoStatus.Information > 設定為零。
作業
如果驅動程式藉由呼叫 WmiSystemControl 來處理 WMI IRP，該常式會呼叫驅動程式的 DpWmiSetDataBlock 常式，如果驅動程式未定義常式，則會傳回STATUS_WMI_READ_ONLY。
如果驅動程式處理 IRP_MN_CHANGE_SINGLE_INSTANCE 要求本身，只有在 Parameters.WMI.ProviderId 上的裝置物件指標符合驅動程式對 IoWMIRegistrationControl的呼叫中傳遞的指標時，才會這麼做。 否則，驅動程式必須將要求轉送至下一個較低的驅動程式。
如果驅動程式處理要求，它必須先檢查 Parameters.WMI.DataPath 上的 GUID，以判斷它是否識別驅動程式支援的資料區塊。 如果沒有，驅動程式必須失敗 IRP 並傳回STATUS_WMI_GUID_NOT_FOUND。
如果驅動程式支援資料區塊，則必須在Parameters.WMI.Buffer檢查收到的WNODE_SINGLE_INSTANCE結構，以取得實例名稱，如下所示：
如果在 WnodeHeader.Flags中設定WNODE_FLAG_STATIC_INSTANCE_NAMES，驅動程式會使用 InstanceIndex 做為該區塊之靜態實例名稱的索引。 WMI 會從驅動程式註冊區塊時所提供的註冊資料取得索引。
如果 WnodeHeader.Flags 中清除WNODE_FLAG_STATIC_INSTANCE_NAMES，驅動程式會使用 OffsetInstanceName 的位移，在輸入 WNODE_SINGLE_INSTANCE中尋找實例名稱字串。 OffsetInstanceName 是結構開頭到實例名稱字串的位元組長度的位移，以位元組為單位， (不是字元) ，包括終止 Null，後面接著 Unicode 中的實例名稱字串。
驅動程式負責驗證所有輸入值。 具體而言，如果驅動程式處理 IRP 要求本身，則必須執行下列動作：
針對靜態名稱，請確認WNODE_SINGLE_INSTANCE結構的InstanceIndex成員位於資料區塊驅動程式支援的實例索引範圍內。
針對動態名稱，請確認實例名稱字串識別驅動程式支援的資料區塊實例。
確認WNODE_SINGLE_INSTANCE結構的DataBlockOffset和SizeDataBlock成員描述有效的資料區塊，包括資料項目之間存在的任何填補，以及緩衝區的內容對資料區塊有效。
確認指定的資料區塊是驅動程式允許呼叫端起始的修改之一。 換句話說，驅動程式不應該允許修改您想要唯讀的資料區塊。
請勿假設執行緒內容是起始使用者模式應用程式的執行緒內容， 較高層級的驅動程式可能會變更它。
如果驅動程式找不到指定的實例，它必須失敗 IRP 並傳回STATUS_WMI_INSTANCE_NOT_FOUND。 如果實例具有動態實例名稱，此狀態表示驅動程式不支援 實例。 因此，WMI 可以繼續查詢其他資料提供者，如果另一個提供者找到實例，但因其他原因而無法處理要求，則傳回適當的錯誤給資料取用者。
如果驅動程式找到 實例並可以處理要求，它會將 實例中的可寫入資料項目設定為 WNODE_SINGLE_INSTANCE 結構中的值，讓任何唯讀專案保持不變。 如果整個資料區塊是唯讀的，驅動程式應該會失敗 IRP 並傳回STATUS_WMI_READ_ONLY。
如果實例有效，但驅動程式無法處理要求，它可以傳回任何適當的錯誤狀態。
規格需求
標頭 |
Wdm.h (包括 Wdm.h、Ntddk.h 或 Ntifs.h) |