ScsiPortWmiGetInstanceName 函数 (scsiwmi.h)

ScsiPortWmiGetInstanceName 例程返回指向与指示的 windows Management Instrumentation(WMI) SCSI 请求块(SRB)关联的实例名称的指针。

注意 SCSI 端口驱动程序和 SCSI 微型端口驱动程序模型将来可能会更改或不可用。 相反,我们建议使用 Storport 驱动程序Storport 微型端口 驱动程序模型。
 

语法

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

参数

[in] RequestContext

指向包含 WMI SRB 请求上下文的 SCSIWMI_REQUEST_CONTEXT 类型的结构的指针。

返回值

指向包含与所指示 SRB 关联的实例名称的计数字符串的指针。 如果 SRB 类型不是使用实例名称的类型,ScsiPortWmiGetInstanceName 返回 NULL

言论

参数 RequestContext 指向包含与 Windows Management Instrumentation(WMI) SCSI 请求块(SRB)关联的信息的请求上下文结构 SCSIWMI_REQUEST_CONTEXT。 请求上下文结构又包含 WMI WNODE_XXX结构 ,WMI 系统用来在用户模式数据使用者和内核模式数据提供程序(如驱动程序)之间传递数据。

请求上下文中包含的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