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 指向包含与 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) |