Función AcxStreamDispatchAcxRequest (acxstreams.h)

AcxStreamDispatchAcxRequest envía una solicitud ACX mediante un objeto de solicitud de marco WDFREQUEST. Se llama a AcxStreamDispatchAcxRequest dentro del contexto de un controlador de eventos de EVT_ACX_OBJECT_PREPROCESS_REQUEST registrado a través de AcxStreamInitAssignAcxRequestPreprocessCallback para indicar que el marco de ACX debe controlar la solicitud.

Sintaxis

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

Parámetros

Stream

Objeto ACXSTREAM existente. Un objeto ACXSTREAM representa una secuencia de audio creada por un circuito. Para obtener más información, vea ACX : resumen de objetos ACX.

Request

Identificador de objeto WDFREQUEST que se pasó al controlador de eventos EVT_ACX_OBJECT_PREPROCESS_REQUEST . Para obtener información general sobre las solicitudes de WDF, vea Creating Framework Request Objects.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Para cualquier llamada al EVT_ACX_OBJECT_PREPROCESS_REQUEST del controlador para un objeto AcxStream, el controlador debe llamar a WdfRequestComplete o AcxStreamDispatchAcxRequest, pero no a ambos.

Ejemplo

A continuación se muestra el uso de ejemplo.

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);
}

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxstreams.h
IRQL PASSIVE_LEVEL

Consulte también