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 系统 用来在用户模式数据使用者和内核模式数据提供程序（如驱动程序）之间传递数据的 WMI WNODE_XXX 结构之一。
请求上下文中包含的WNODE_XXX结构包含与 WMI SRB 关联的实例名称。 微型端口驱动程序调用 ScsiPortWmiGetInstanceName ，以从请求上下文中提取此实例名称。
在微型端口驱动程序调用 ScsiPortWmiPostProcess 并且 ScsiPortWmiPostProcess 返回最终 SRB 状态和缓冲区大小之前，为请求上下文分配的内存必须保持有效。 如果 SRB 可以笔，则应从 SRB 扩展分配请求上下文的内存。 如果 SRB 无法笔画，则可以从不超出范围的堆栈帧分配内存。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | scsiwmi.h (包括 Miniport.h、Scsi.h) |