AcxTargetStreamCreate, fonction (acxtargets.h)
La fonction AcxTargetStreamCreate est utilisée pour créer un flux cible.
Syntaxe
NTSTATUS AcxTargetStreamCreate(
WDFDEVICE Device,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_TARGET_STREAM_CONFIG Config,
ACXTARGETSTREAM *TargetStream
);
Paramètres
Device
Objet WDFDEVICE (décrit dans Summary of Framework Objects) associé à l’ACXCIRCUIT actuel.
Attributes
Attributs supplémentaires définis à l’aide d’une structure WDF_OBJECT_ATTRIBUTES utilisée pour définir les valeurs de différents objets : nettoyage et destruction des rappels, type de contexte et spécification de son objet parent.
Config
Structure de ACX_TARGET_STREAM_CONFIG initialisée qui décrit la configuration du flux cible.
TargetStream
Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet ACXTARGETSTREAM. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.
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
Les pilotes doivent utiliser ACXSTREAMBRIDGE pour propager automatiquement un flux audio de bas niveau vers les autres circuits connectés.
Exemple
WDF_OBJECT_ATTRIBUTES attributes;
PAGGREGATOR_PIN_CONTEXT pinCtx;
ACXSTREAM stream;
AGGREGATOR_STREAM_CONTEXT* streamCtx;
ACX_TARGET_STREAM_CONFIG targetStreamCfg;
streamCtx = GetAggregatorStreamContext(stream);
ASSERT(streamCtx);
streamCtx->StreamState = AcxStreamStateStop;
pinCtx = GetAggregatorPinContext(Pin);
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = stream;
...
ACX_TARGET_STREAM_CONFIG_INIT(&targetStreamCfg);
targetStreamCfg.TargetCircuit = pinCtx->TargetPins[i]->TargetCircuit;
targetStreamCfg.PinId = pinCtx->TargetPins[i]->TargetPinId;
targetStreamCfg.DataFormat = StreamFormat;
targetStreamCfg.SignalProcessingMode = SignalProcessingMode;
targetStreamCfg.OptionalParameters = VarArguments;
...
status = AcxTargetStreamCreate(Device, &attributes, &targetStreamCfg, &streamCtx->TargetStreams[i]);
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 | acxtargets.h |
| IRQL | PASSIVE_LEVEL |