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

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

  • Статья

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

Синтаксис

NTSTATUS AcxTargetPinFormatRequestForMethod(
  ACXTARGETPIN            TargetPin,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Параметры

TargetPin

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

Request

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

Params

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

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

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

Комментарии

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

Пример

...
    _In_    ACXTARGETCIRCUIT TargetCircuit,
    _In_    ULONG            TargetPinId
    )

    NTSTATUS                    status;
    WDFREQUEST                  req;
    ACX_REQUEST_PARAMETERS      params;
    ACXTARGETPIN                targetPin = NULL;

...

    //
    // Get the target pin obj.
    //
    targetPin = AcxTargetCircuitGetTargetPin(TargetCircuit, TargetPinId);

    //
    // Format a WDF request for the target.
    //
    status = AcxTargetPinFormatRequestForMethod(targetPin, req, &params);

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

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

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

Требования

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

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