调用微型端口驱动程序的 HwScsiWmiQueryReginfo 例程以获取有关 SCSI 端口驱动程序代表微型端口驱动程序注册的数据和事件块的信息。 此例程是必需的。
注意 SCSI 端口驱动程序和 SCSI 微型端口驱动程序模型将来可能会更改或不可用。 相反，我们建议使用 Storport 驱动程序，Storport 微型端口 驱动程序模型。
语法
PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;
UCHAR PscsiwmiQueryReginfo(
[in] PVOID DeviceContext,
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext,
[out] PWSTR *MofResourceName
)
{...}
参数
[in] DeviceContext
指向传递给 ScsiPortWmiDispatchFunction的微型端口驱动程序定义的上下文值。
[in] RequestContext
指向微型端口驱动程序传递给 ScsiPortWmiDispatchFunction的SCSIWMI_REQUEST_CONTEXT结构。
[out] MofResourceName
指向 null-terminated Unicode 字符串，该字符串指示附加到微型端口驱动程序的二进制映像文件的 MOF 资源的名称。 此字符串可以在微型端口驱动程序中声明为常量。 如果微型端口驱动程序未附加 MOF 资源，则应将 mofResourceName 设置为 NULL。
返回值
HwScsiWmiQueryReginfo 始终返回SRB_STATUS_SUCCESS。
言论
当微型端口驱动程序收到一个 SRB，其中 函数 成员设置为SRB_FUNCTION_WMI时，它将调用 ScsiPortWmiDispatchFunction，其指针指向初始化的SCSI_WMILIB_CONTEXT结构，MinorFunction 设置为 Srb->WmiSubFunction。 如果 MinorFunction 指示注册信息的请求，SCSI 端口驱动程序将调用微型端口驱动程序的 HwScsiWmiQueryReginfo 例程。
微型端口驱动程序在传递给 ScsiPortWmiDispatchFunction 的SCSI_WMILIB_CONTEXT结构中提供有关单个块的新注册或更新的注册信息，或指示要删除的块。 微型端口驱动程序的 HwScsiWmiQueryReginfo 例程提供指向其 MOF 资源名称的指针。
微型端口驱动程序不得笔触或阻止 SRB。 微型端口驱动程序不得从其 HwScsiWmiQueryReginfo 例程调用 ScsiPortWmiPostProcess 或 ScsiPortNotification。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | scsiwmi.h （包括 Scsiwmi.h） |