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

Статья
10/05/2023

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

Синтаксис

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

Параметры

TargetElement

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

Request

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

Params

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

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

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

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

Пример

В этом примере кода показано использование AcxTargetElementFormatRequestForMethod.


    {
        ACXTARGETELEMENT targetElement          = NULL;
        ULONG            targetElementId        = 0;
        ULONG            targetElementsCount    = AcxTargetCircuitGetElementsCount(TargetCircuit);
        arg     = elementArg;
        result  = 0;

        targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, targetElementId);       

        ACX_REQUEST_PARAMETERS_INIT_METHOD(
            &params,
            KSMETHODSETID_AcxTestMethod,
            KSMETHOD_ACXELEMENT_TEST_IN2OUT,
            AcxMethodVerbSend,
            AcxItemTypeElement,
            targetElementId,
            &arg, sizeof(arg),      // Value & size
            &result, sizeof(result) // Control & size
            );  

        //
        // Format a WDF request as an ACX method request for the ACX element target.
        //
        status = AcxTargetElementFormatRequestForMethod(targetElement, req, &params);

Требования к ACX

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

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

Требования

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

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

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

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