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)

另请参阅

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE