AcxStreamDispatchAcxRequest, fonction (acxstreams.h)
La AcxStreamDispatchAcxRequest distribue une requête ACX à l’aide d’un objet de requête de framework 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 requête 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 plus d’informations générales sur les requêtes WDF, consultez Création d’objets de requête framework.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Pour tout appel au 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 minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxstreams.h |
| IRQL | PASSIVE_LEVEL |