Compartilhar via


Função AcxTargetStreamCreate (acxtargets.h)

A função AcxTargetStreamCreate é usada para criar um fluxo de destino.

Sintaxe

NTSTATUS AcxTargetStreamCreate(
  WDFDEVICE                 Device,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_TARGET_STREAM_CONFIG Config,
  ACXTARGETSTREAM           *TargetStream
);

Parâmetros

Device

Um objeto WDFDEVICE (descrito em Resumo de Objetos de Estrutura) associado ao ACXCIRCUIT atual.

Attributes

Atributos adicionais definidos usando uma estrutura WDF_OBJECT_ATTRIBUTES usada para definir valores de vários objetos: limpar e destruir retornos de chamada, tipo de contexto e especificar seu objeto pai.

Config

Uma estrutura de ACX_TARGET_STREAM_CONFIG inicializada que descreve a configuração do fluxo de destino.

TargetStream

Um ponteiro para um local que recebe um identificador para o novo objeto ACXTARGETSTREAM. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Os drivers devem usar o ACXSTREAMBRIDGE para propagar automaticamente um fluxo de áudio de nível inferior para os outros circuitos conectados.

Exemplo


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

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxtargets.h
IRQL PASSIVE_LEVEL

Confira também