PSCSIWMI_QUERY_REGINFO回调函数 (scsiwmi.h)

调用微型端口驱动程序的 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 结尾的 Unicode 字符串，该字符串指示附加到微型端口驱动程序的二进制映像文件的 MOF 资源的名称。 此字符串可以在微型端口驱动程序中声明为常量。 如果微型端口驱动程序没有附加 MOF 资源，则应将 MofResourceName 设置为 NULL。

返回值

HwScsiWmiQueryReginfo 始终返回SRB_STATUS_SUCCESS。

注解

当微型端口驱动程序收到函数成员设置为SRB_FUNCTION_WMI的 SRB 时，它会调用 ScsiPortWmiDispatchFunction，其中包含指向初始化的 SCSI_WMILIB_CONTEXT 结构的指针，并将 MinorFunction 设置为 Srb-WmiSubFunction>。 如果 MinorFunction 指示注册信息请求，则 SCSI 端口驱动程序将调用微型端口驱动程序的 HwScsiWmiQueryReginfo 例程。

微型端口驱动程序在传递给 ScsiPortWmiDispatchFunction 的SCSI_WMILIB_CONTEXT结构中提供有关各个块的新的或更新的注册信息，或指示要删除的块。 微型端口驱动程序的 HwScsiWmiQueryReginfo 例程提供指向其 MOF 资源名称的指针。

微型端口驱动程序不得设置或阻止 SRB。 微型端口驱动程序不得从其 HwScsiWmiQueryReginfo 例程调用 ScsiPortWmiPostProcess 或 ScsiPortNotification。

要求

要求	值
目标平台	桌面
标头	scsiwmi.h (包括 Scsiwmi.h)

另请参阅

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction