Функция AcxStreamDispatchAcxRequest (acxstreams.h)

AcxStreamDispatchAcxRequest отправляет запрос ACX с помощью объекта запроса платформы WDFREQUEST. AcxStreamDispatchAcxRequest вызывается в контексте обработчика событий EVT_ACX_OBJECT_PREPROCESS_REQUEST , зарегистрированного с помощью AcxStreamInitAssignAcxRequestPreprocessCallback , чтобы указать, что запрос должен обрабатываться платформой ACX.

Синтаксис

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

Параметры

Stream

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

Request

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

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

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

Комментарии

Для любого вызова EVT_ACX_OBJECT_PREPROCESS_REQUEST драйвера для объекта AcxStream драйвер должен вызывать WdfRequestComplete или AcxStreamDispatchAcxRequest, но не оба.

Пример

Ниже приведен пример использования.

VOID
Codec_EvtStreamRequestPreprocess(
    _In_    ACXOBJECT  Object,
    _In_    ACXCONTEXT DriverContext,
    _In_    WDFREQUEST Request
    )
/*++

Routine Description:

    This function is an example of a preprocess routine.

--*/
{
    //
    // Just give the request back to ACX. Normally the driver would take steps to examine
    // the Request and take action if necessary.
    //
    AcxStreamDispatchAcxRequest((ACXSTREAM)Object, Request);
}

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

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

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

Требования

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

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

• Заголовок acxstreams.h