Freigeben über

AcxStreamDispatchAcxRequest-Funktion (acxstreams.h)

Die AcxStreamDispatchAcxRequest eine ACX-Anforderung mithilfe eines WDFREQUEST-Framework-Anforderungsobjekts verteilt. AcxStreamDispatchAcxRequest wird im Kontext eines EVT_ACX_OBJECT_PREPROCESS_REQUEST Ereignishandlers aufgerufen, der über AcxStreamInitAssignAcxRequestPreprocessCallback registriert ist, 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 Von einem Schaltkreis erstellten Audiodatenstrom dar. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX Objects.

Request

Das WDFREQUEST-Objekthandle, das an den EVT_ACX_OBJECT_PREPROCESS_REQUEST-Ereignishandler übergeben wurde. Allgemeine Informationen zu WDF-Anforderungen finden Sie unter Creating Framework Request Objects.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Für jeden 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 Beispielverwendung wird unten gezeigt.

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

Mindestens ACX-Version: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header- acxstreams.h
IRQL- PASSIVE_LEVEL

Siehe auch