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 |