Função AcxDeviceDetachCircuit (acxdevice.h)

  • Artigo

A função AcxDeviceDetachCircuit desanexa um circuito de áudio de um WDFDEVICE antes da remoção.

Sintaxe

NTSTATUS AcxDeviceDetachCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parâmetros

Device

O WDFDEVICE do qual desanexar 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

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

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

AcxDeviceDetachCircuit desanexa o circuito do dispositivo. O chamador é responsável por excluir o objeto ACXCIRCUIT .

Comentários

Exemplo

WDFDEVICE                    Device;
NTSTATUS                     status;
PCODEC_RENDER_DEVICE_CONTEXT renderDevCtx = NULL;

// Code to initialize WDFDEVICE...

renderDevCtx = GetRenderDeviceContext(Device);

ASSERT(renderDevCtx->Circuit);
status = AcxDeviceDetachCircuit(Device, renderDevCtx->Circuit);

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