Funzione AcxStreamDispatchAcxRequest (acxstreams.h)
AcxStreamDispatchAcxRequest invia una richiesta ACX usando un oggetto richiesta del framework WDFREQUEST. AcxStreamDispatchAcxRequest viene chiamato nel contesto di un gestore eventi EVT_ACX_OBJECT_PREPROCESS_REQUEST registrato tramite AcxStreamInitAssignAcxRequestPreprocessCallback per indicare che la richiesta deve essere gestita dal framework ACX.
Sintassi
NTSTATUS AcxStreamDispatchAcxRequest(
ACXSTREAM Stream,
WDFREQUEST Request
);
Parametri
Stream
Oggetto ACXSTREAM esistente. Un oggetto ACXSTREAM rappresenta un flusso audio creato da un circuito. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.
Request
Handle dell'oggetto WDFREQUEST passato al gestore eventi EVT_ACX_OBJECT_PREPROCESS_REQUEST . Per informazioni generali sulle richieste WDF, vedere Creazione di oggetti richiesta framework.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Per qualsiasi chiamata al EVT_ACX_OBJECT_PREPROCESS_REQUEST del driver per un oggetto AcxStream, il driver deve chiamare WdfRequestComplete o AcxStreamDispatchAcxRequest, ma non entrambi.
Esempio
Di seguito è riportato l'esempio di utilizzo.
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);
}
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxstreams.h |
| IRQL | PASSIVE_LEVEL |