функция обратного вызова 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

Указывает на структуру SCSIWMI_REQUEST_CONTEXT, переданную драйвером мини-порта в ScsiPortWmiDispatchFunction.

[out] MofResourceName

Указывает на строку Юникода, завершающуюся null, которая указывает имя ресурса MOF, присоединенного к двоичному файлу образа драйвера miniport. Эту строку можно объявить как константу в драйвере мини-порта. Если к драйверу мини-порта не подключен ресурс MOF, ему следует задать для MofResourceNameзначение NULL.

Возвращаемое значение

HwScsiWmiQueryReginfo всегда возвращает SRB_STATUS_SUCCESS.

Комментарии

Когда драйвер мини-порта получает SRB, в котором член Функции имеет значение SRB_FUNCTION_WMI, он вызывает ScsiPortWmiDispatchFunction с указателем на инициализированную структуру SCSI_WMILIB_CONTEXT, а minorFunction — Srb-WmiSubFunction>. Если MinorFunction указывает на запрос сведений о регистрации, драйвер порта SCSI вызывает подпрограмму HwScsiWmiQueryReginfo драйвера мини-порта.

Драйвер мини-порта предоставляет новые или обновленные регистрационные сведения об отдельных блоках или указывает блоки для удаления в SCSI_WMILIB_CONTEXT структуре, которую он передает в ScsiPortWmiDispatchFunction. Подпрограмма HwScsiWmiQueryReginfo драйвера мини-порта предоставляет указатель на имя ресурса MOF.

Драйвер мини-порта не должен выполнять или блокировать SRB. Драйвер мини-порта не должен вызывать ScsiPortWmiPostProcess или ScsiPortNotification из своей подпрограммы HwScsiWmiQueryReginfo .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть scsiwmi.h (включая Scsiwmi.h)

См. также раздел

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction