Função AcxStreamAudioEngineCreate (acxelements.h)

  • Artigo

A função AcxStreamAudioEngineCreate é usada para criar um objeto do mecanismo de áudio de fluxo ACX que será associado a um objeto de fluxo do ACX pai. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Sintaxe

NTSTATUS AcxStreamAudioEngineCreate(
  ACXSTREAM                     Stream,
  ACXAUDIOENGINE                AudioEngine,
  PWDF_OBJECT_ATTRIBUTES        Attributes,
  PACX_STREAMAUDIOENGINE_CONFIG Config,
  ACXSTREAMAUDIOENGINE          *StreamAudioEngine
);

Parâmetros

Stream

Um objeto ACXSTREAM que representa um fluxo de áudio no hardware de um circuito específico. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

AudioEngine

Um objeto ACXAUDIOENGINE usado em um circuito de renderização para representar um DSP. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Attributes

Atributos adicionais definidos usando uma estrutura WDF_OBJECT_ATTRIBUTES que são usadas para definir vários valores e associar o mecanismo de áudio de fluxo ao objeto de fluxo pai.

Config

Uma estrutura de ACX_STREAMAUDIOENGINE_CONFIG inicializada que descreve a configuração do mecanismo de áudio de fluxo.

StreamAudioEngine

Um ponteiro para um local que recebe o identificador para o objeto ACXSTREAMAUDIOENGINE recém-criado. 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

Exemplo

O uso de exemplo é mostrado abaixo.

    NTSTATUS                        status;
    WDF_OBJECT_ATTRIBUTES           attributes;
    ACXSTREAM                       stream;
    ACXELEMENT                      elements[2] = {0};
    ACX_STREAMAUDIOENGINE_CONFIG    audioEngineCfg;

        ACX_STREAMAUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
        audioEngineCfg.VolumeElement = volumeElement;
        audioEngineCfg.MuteElement = muteElement;
        audioEngineCfg.PeakMeterElement = peakmeterElement;
        audioEngineCfg.Callbacks = &streamAudioEngineCallbacks;

        WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, CODEC_STREAMAUDIOENGINE_CONTEXT);
        attributes.ParentObject = stream;

        status = AcxStreamAudioEngineCreate(stream, circuitCtx->AudioEngineElement, &attributes, &audioEngineCfg, (ACXSTREAMAUDIOENGINE*)&elements[0]);

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 acxelements.h
IRQL PASSIVE_LEVEL

Confira também