Partilhar via

Função AcxDeviceRemoveFactoryCircuit (acxdevice.h)

  • Artigo

A função AcxDeviceRemoveFactoryCircuit remove um circuito de fábrica para criar circuitos de áudio de umWDFDEVICE .

Sintaxe

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Parâmetros

Device

O WDFDEVICE do qual o circuito de fábrica do ACX será removido.

Factory

O circuito de fábrica do ACX a ser removido do WDFDEVICE especificado pelo parâmetro dispositivo .

Valor de retorno

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

Observações

Um driver típico não precisará chamar AcxDeviceRemoveFactoryCircuit . Essa função não deve ser chamada se o circuito de fábrica tiver criado dispositivos de circuito que ainda estão ativos.

Se um driver decidir chamar essa função para um circuito de fábrica, o driver se tornará responsável por remover primeiro os dispositivos de circuito criados por meio do circuito de fábrica associado, antes deAcxDeviceRemoveFactoryCircuit for chamado.

Para obter mais informações sobre como trabalhar com circuitos, consulte de remoção dinâmica do circuito ACX e de enumeração de dispositivo ACX.

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

Use AcxDeviceAddFactoryCircuit para adicionar um circuito de fábrica a umWDFDEVICE .

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

Consulte também