Función AcxStreamDispatchAcxRequest (acxstreams.h)
El AcxStreamDispatchAcxRequest envía una solicitud ACX mediante un objeto de solicitud de marco WDFREQUEST. Se llama a AcxStreamDispatchAcxRequest en el 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 Using NTSTATUS Values.
Observaciones
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 |
|---|---|
| encabezado de | acxstreams.h |
| irQL | PASSIVE_LEVEL |