Функция 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