Freigeben über

AcxStreamDispatchAcxRequest-Funktion (acxstreams.h)

  • Artikel

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

Weitere Informationen