ScsiPortWmiGetInstanceName 函式 (scsiwmi.h)
ScsiPortWmiGetInstanceName 例程會傳回與所指示 Windows Management Instrumentation (WMI) SCSI 要求區塊 (SRB) 相關聯的實例名稱指標。
語法
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
參數
[in] RequestContext
包含 WMI SRB 要求內容之類型 SCSIWMI_REQUEST_CONTEXT 結構的指標。
傳回值
包含與指定 SRB 相關聯之實例名稱之計數位符串的指標。 如果 SRB 類型不是使用實體名稱的類型,ScsiPortWmiGetInstanceName 會傳回 null 。
言論
參數 RequestContext 指向要求內容結構,SCSIWMI_REQUEST_CONTEXT,其中包含與 Windows Management Instrumentation (WMI) SCSI 要求區塊 (SRB) 相關聯的資訊。 要求內容結構接著會包含其中一個 WMI WNODE_XXX 結構 WMI 系統用來在使用者模式數據取用者和驅動程式等核心模式數據提供者之間傳遞數據。
要求內容中包含的WNODE_XXX結構會保留與 WMI SRB 相關聯的實例名稱。 迷你埠驅動程式會呼叫 ScsiPortWmiGetInstanceName,以從要求內容擷取此實例名稱。
配置給要求內容的記憶體必須維持有效狀態,直到迷你埠驅動程式呼叫 ScsiPortWmiPostProcess之後,ScsiPortWmiPostProcess 會傳回最終 SRB 狀態和緩衝區大小。 如果 SRB 可以畫筆,應該從 SRB 擴充功能配置要求內容的記憶體。 如果 SRB 無法畫筆,則可以從未超出範圍的堆疊框架配置記憶體。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | scsiwmi.h (包括 Miniport.h、Scsi.h) |