AcxStreamDispatchAcxRequest, fonction (acxstreams.h)

  • Article

AcxStreamDispatchAcxRequest distribue une requête ACX à l’aide d’un objet de requête d’infrastructure WDFREQUEST. AcxStreamDispatchAcxRequest est appelé dans le contexte d’un gestionnaire d’événements EVT_ACX_OBJECT_PREPROCESS_REQUEST inscrit via AcxStreamInitAssignAcxRequestPreprocessCallback pour indiquer que la demande doit être gérée par l’infrastructure ACX.

Syntaxe

NTSTATUS AcxStreamDispatchAcxRequest(
  ACXSTREAM  Stream,
  WDFREQUEST Request
);

Paramètres

Stream

Objet ACXSTREAM existant. Un objet ACXSTREAM représente un flux audio créé par un circuit. Pour plus d’informations, consultez ACX - Résumé des objets ACX.

Request

Handle d’objet WDFREQUEST qui a été transmis au gestionnaire d’événements EVT_ACX_OBJECT_PREPROCESS_REQUEST . Pour obtenir des informations générales sur les requêtes WDF, consultez Création d’objets de requête d’infrastructure.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Pour tout appel à l’EVT_ACX_OBJECT_PREPROCESS_REQUEST du pilote pour un objet AcxStream, le pilote doit appeler WdfRequestComplete ou AcxStreamDispatchAcxRequest, mais pas les deux.

Exemple

L’exemple d’utilisation est illustré ci-dessous.

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);
}

Configuration requise pour ACX

Version ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxstreams.h
IRQL PASSIVE_LEVEL

Voir aussi