ScsiPortWmiGetInstanceName 函式 (scsiwmi.h)
ScsiPortWmiGetInstanceName 例程會傳回與指出 Windows Management Instrumentation (WMI) SCSI 要求區塊 (SRB) 相關聯的實例名稱指標。
注意 未來可能會變更或無法使用 SCSI 埠驅動程式和 SCSI 迷你埠驅動程式模型。 相反地，我們建議使用 Storport 驅動程式 和 Storport 迷你埠 驅動程式模型。
語法
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
參數
[in] RequestContext
型 別結構SCSIWMI_REQUEST_CONTEXT 的指標，其中包含 WMI SRB 的要求內容。
傳回值
包含與指定 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) |