Compartilhar via

Função AcxDeviceAddFactoryCircuit (acxdevice.h)

  • Artigo

A função AcxDeviceAddFactoryCircuit adiciona um circuito de fábrica a um WDFDEVICE para criar circuitos de áudio.

Sintaxe

NTSTATUS AcxDeviceAddFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Parâmetros

Device

Um WDFDEVICE ao qual o circuito de fábrica do ACX será adicionado.

Factory

O circuito de fábrica do ACX a ser adicionado ao WDFDEVICE especificado pelo parâmetro Device .

Retornar valor

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

Comentários

Um driver ACX pode criar um ou mais circuitos nos seguintes cenários:

  • No momento da inicialização
  • Em tempo de execução, como efeito colateral de um evento externo, como detectar um novo componente de áudio
  • Porque ele se registrou com o ACX como fábrica de circuitos. A estrutura ACX usa a fábrica registrada para pedir ao driver para criar um novo circuito.

Use AcxDeviceRemoveFactoryCircuit para remover um circuito de fábrica de um WDFDEVICE.

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;
PCAPTURE_DEVICE_CONTEXT  devCtx;

// Code to initialize WDFDEVICE...

//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);

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 as 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