Поделиться через


Функция ScsiPortWmiGetInstanceName (scsiwmi.h)

Подпрограмма ScsiPortWmiGetInstanceName возвращает указатель на имя экземпляра, связанное с указанным блоком запросов SCSI (SRB) инструментария управления Windows (WMI).

Примечание В будущем модели драйвера портов SCSI и драйвера для минипорта SCSI могут быть изменены или недоступны. Вместо этого рекомендуется использовать модели драйверов Storport и драйверов для мини-портов Storport .
 

Синтаксис

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

Параметры

[in] RequestContext

Указатель на структуру типа SCSIWMI_REQUEST_CONTEXT , которая содержит контекст запроса для WMI SRB.

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

Указатель на подсчитываемую строку, содержащую имя экземпляра, связанное с указанным SRB. Если тип SRB не использует имя экземпляра, ScsiPortWmiGetInstanceName возвращает значение NULL.

Комментарии

Параметр RequestContext указывает на структуру контекста запроса , SCSIWMI_REQUEST_CONTEXT, которая содержит сведения, связанные с блоком запросов SCSI (SRB) инструментария управления Windows (WMI). Структура контекста запроса, в свою очередь, содержит одну из структур 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