AcxStreamDispatchAcxRequest-Funktion (acxstreams.h)
AcxStreamDispatchAcxRequest sendet eine ACX-Anforderung mithilfe eines WDFREQUEST-Frameworkanforderungsobjekts. AcxStreamDispatchAcxRequest wird im Kontext eines überAcxStreamInitAssignAcxRequestPreprocessCallback registrierten EVT_ACX_OBJECT_PREPROCESS_REQUEST-Ereignishandlers aufgerufen, um anzugeben, dass die Anforderung vom ACX-Framework verarbeitet werden soll.
Syntax
NTSTATUS AcxStreamDispatchAcxRequest(
ACXSTREAM Stream,
WDFREQUEST Request
);
Parameter
Stream
Ein vorhandenes ACXSTREAM-Objekt . Ein ACXSTREAM-Objekt stellt einen audiostream dar, der von einer Verbindung erstellt wird. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX-Objekten.
Request
Das WDFREQUEST-Objekthandle, das an den EVT_ACX_OBJECT_PREPROCESS_REQUEST-Ereignishandler übergeben wurde. Allgemeine Informationen zu WDF-Anforderungen finden Sie unter Erstellen von Framework-Anforderungsobjekten.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Hinweise
Bei jedem Aufruf der EVT_ACX_OBJECT_PREPROCESS_REQUEST des Treibers für ein AcxStream-Objekt sollte der Treiber entweder WdfRequestComplete oder AcxStreamDispatchAcxRequest aufrufen, aber nicht beides.
Beispiel
Die Verwendungsbeispiele finden Sie unten.
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-Anforderungen
AcX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxstreams.h |
| IRQL | PASSIVE_LEVEL |