Функция SCSIPortWmiGetInstanceName (scsiwmi.h)
Подпрограмма ScsiPortWmiGetInstanceName возвращает указатель на имя экземпляра, связанное с указанным блоком запросов управления Windows (WMI).
Синтаксис
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
Параметры
[in] RequestContext
Указатель на структуру типа SCSIWMI_REQUEST_CONTEXT, содержащую контекст запроса для SRB WMI.
Возвращаемое значение
Указатель на подсчитываемую строку, содержащую имя экземпляра, связанное с указанным SRB. Если тип SRB не использует имя экземпляра, ScsiPortWmiGetInstanceName возвращает значение NULL.
Замечания
Параметр RequestContext указывает на структуру контекста запроса SCSIWMI_REQUEST_CONTEXT, которая содержит сведения, связанные с блок ом запросов управления Windows (WMI). Структура контекста запроса, в свою очередь, содержит одну из структур WMI WNODE_XXX структур, которые используются системой WMI для передачи данных между потребителями данных в пользовательском режиме и поставщиками данных в режиме ядра, такими как драйверы.
Структура WNODE_XXX, содержащаяся в контексте запроса, содержит имя экземпляра, связанное с SRB WMI. Драйвер минипорта вызывает ScsiPortWmiGetInstanceName, чтобы извлечь это имя экземпляра из контекста запроса.
Память, выделенная для контекста запроса, должна оставаться допустимой до тех пор, пока драйвер минипорта не вызывает ScsiPortWmiPostProcess, а ScsiPortWmiPostProcess возвращает окончательное состояние И буферный размер. Если SRB может задается, память для контекста запроса должна быть выделена из расширения SRB. Если SRB не может быть показано, память может быть выделена из кадра стека, который не выходит из области.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | scsiwmi.h (include Miniport.h, Scsi.h) |