Função AcxDeviceAddCircuit (acxdevice.h)

  • Artigo

A função AcxDeviceAddCircuit adiciona um circuito ACX a um WDFDEVICE para criar um ponto de extremidade de áudio.

Sintaxe

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parâmetros

Device

Um WDFDEVICE que representa o dispositivo ao qual o circuito será adicionado.

Circuit

O circuito a ser adicionado ao Dispositivo.

Retornar valor

AcxDeviceAddCircuit retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS .

Comentários

O circuito de áudio é o bloco de construção principal do ACX. Um driver de áudio cria um ou mais objetos de circuito ACX para representar um caminho de controle e dados de áudio parcial ou completo. O ACX reúne esses objetos de circuito ACX para criar um caminho de áudio completo que representa um ponto de extremidade de áudio.

Essa função só pode ser chamada da função de retorno de chamada EVT_WDF_DEVICE_PREPARE_HARDWARE para este dispositivo.

Exemplo

WDFDEVICE             Device;
NTSTATUS              status;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

if (!NT_SUCCESS(status)) 
{
    ASSERT(FALSE);
    goto exit;
}

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

Confira também