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

Статья
02/06/2025

AcxTargetCircuitFormatRequestForProperty форматирует WDFREQUEST в качестве запроса свойства ACX, который будет использоваться в указанном целевом объекте канала.

Синтаксис

NTSTATUS AcxTargetCircuitFormatRequestForProperty(
  ACXTARGETCIRCUIT        TargetCircuit,
  WDFREQUEST              Request,
  PACX_REQUEST_PARAMETERS Params
);

Параметры

TargetCircuit

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

Request

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

Params

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

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

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

Замечания

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

Пример


    ACX_REQUEST_PARAMETERS      params;
    WDFREQUEST                  req;
    ACXTARGETCIRCUIT            targetCircuit;

...

    //
    // Format a WDF request as an ACX property request for the ACX circuit target.
    //
    status = AcxTargetCircuitFormatRequestForProperty(targetCircuit, req, &params);

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

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

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

Требования

Требование	Ценность
заголовка	acxtargets.h
IRQL	PASSIVE_LEVEL

См. также

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

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