Функция AcxTargetElementFormatRequestForProperty (acxtargets.h)

Статья
02/22/2024

Функция AcxTargetElementFormatRequestForProperty форматирует WDFREQUEST как запрос свойства ACX для использования в указанном целевом элементе.

Синтаксис

NTSTATUS AcxTargetElementFormatRequestForProperty(
  ACXTARGETELEMENT        TargetElement,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Параметры

TargetElement

Дескриптор ACXTARGETELEMENT. Дополнительные сведения об объектах ACX см. в разделе Сводка по объектам ACX.

Request

Дескриптор WDFREQUEST, описанный в разделе Сводка объектов платформы. Общие сведения о запросах WDF см. в разделе Создание объектов запросов платформы.

Params

Инициализированная структура ACX_REQUEST_PARAMETERS , используемая для хранения сведений о параметрах запроса на свойство.

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

Возвращает значение STATUS_SUCCESS , если вызов был успешным. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

WDFREQUEST — это созданный драйвером запросы ввода-вывода. Драйверы на основе платформы обрабатывают каждый запрос ввода-вывода, вызывая методы объекта запроса платформы. Дополнительные сведения см. в разделе Объекты запроса платформы.

Пример


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETELEMENT            targetElement;

...

    status = AcxTargetElementFormatRequestForProperty(targetElement, req, &params);

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование	Значение
Заголовок	acxtargets.h
IRQL	PASSIVE_LEVEL

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

Заголовок acxtargets.h

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