Функция SpbRequestGetParameters (spbcx.h)

Статья
02/26/2024

Метод SpbRequestGetParameters извлекает набор значений параметров, относящихся к SPB, из запроса ввода-вывода.

Синтаксис

void SpbRequestGetParameters(
  [in]  SPBREQUEST             SpbRequest,
  [out] SPB_REQUEST_PARAMETERS *Parameters
);

Параметры

[in] SpbRequest

Дескриптор SPBREQUEST для запроса ввода-вывода. Драйвер контроллера SPB ранее получил этот дескриптор через одну из своих зарегистрированных функций обратного вызова событий.

[out] Parameters

Указатель на структуру, выделенную вызывающим объектом SPB_REQUEST_PARAMETERS , в которую метод записывает значения параметров SPB из запроса ввода-вывода. Вызывающий объект должен ранее инициализировать эту структуру, вызвав функцию SPB_REQUEST_PARAMETERS_INIT .

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

None

Remarks

SpbRequestGetParameters похож на метод WdfRequestGetParameters , но извлекает только сведения, относящиеся к SPB. Драйвер контроллера SPB может вызывать SpbRequestGetParameters для получения сведений, относящихся к SPB, из запросов ввода-вывода, получаемых от расширения платформы SPB (SpbCx). Драйвер контроллера SPB может вызывать WdfRequestGetParameters , чтобы получить универсальные параметры запроса из получаемых запросов ввода-вывода.

Примеры

В следующем примере кода показано, как использовать SpbRequestGetParameters для получения параметров, относящихся к SPB, из запроса ввода-вывода. Переменная spbRequest содержит дескриптор SPBREQUEST для запроса ввода-вывода.

SPB_REQUEST_PARAMETERS parameters;

SPB_REQUEST_PARAMETERS_INIT(&parameters);

SpbRequestGetParameters(spbRequest, &parameters);

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Универсальное
Верхняя часть	spbcx.h
Библиотека	Spbcxstubs.lib
IRQL	<= DISPATCH_LEVEL