AcxTargetStreamCreate, fonction (acxtargets.h)

  • Article

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 Résumé des objets framework) associé au circuit ACXCIRCUIT actuel.

Attributes

Attributs supplémentaires définis à l’aide d’une structure WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir les valeurs de différents objets : nettoyage et destruction des rappels, type de contexte et pour spécifier son objet parent.

Config

Une structure 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 retournée

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

Remarques

Les pilotes doivent utiliser ACXSTREAMBRIDGE pour propager automatiquement un flux audio de niveau inférieur aux 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 d’ACX

Version minimale d’ACX : 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 acxtargets.h
IRQL PASSIVE_LEVEL

Voir aussi