Função AcxDeviceRemoveCircuit (acxdevice.h)

  • Artigo

A função AcxDeviceRemoveCircuit remove o circuito de áudio especificado de um dispositivo ACX.

Sintaxe

NTSTATUS AcxDeviceRemoveCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parâmetros

Device

O WDFDEVICE do qual remover o circuito de áudio especificado pelo parâmetro Circuit .

Circuit

O circuito de áudio a ser removido do WDFDEVICE especificado pelo parâmetro Device .

Retornar valor

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

Comentários

Use AcxDeviceAddCircuit para adicionar um circuito de áudio a um WDFDEVICE.

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

Exemplo

NTSTATUS              status;
WDFDEVICE             Device = NULL;
PUSBA2_DEVICE_CONTEXT devCtx;

// Code to initialize WDFDEVICE...

devCtx = GetDeviceContext(Device);

//
// Unregister filter and delete this audio filter.
//
if (devCtx->RenderCircuitAdded) {
    ASSERT(devCtx->RenderCircuit);
    status = AcxDeviceRemoveCircuit(Device, devCtx->RenderCircuit);

    devCtx->RenderCircuit = NULL;
    devCtx->RenderCircuitAdded = FALSE;
}

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