Compartilhar via

Função AcxDeviceRemoveCircuitDevice (acxdevice.h)

  • Artigo

A função AcxDeviceRemoveCircuitDevice remove um dispositivo de circuito ACX de um dispositivo pai especificado.

Sintaxe

NTSTATUS AcxDeviceRemoveCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Parâmetros

ParentDevice

O WDFDEVICE pai do qual remover o dispositivo de circuito ACX.

Device

O WDFDEVICE que representa o dispositivo de circuito a ser removido do dispositivo pai.

Valor de retorno

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

Observações

Os drivers de áudio usam essa função para remover um ponto de extremidade de áudio existente.

Essa função pode ser chamada a qualquer momento durante o ciclo de vida do driver. O Plug and Play tem o cuidado de serializar a remoção do dispositivo e os circuitos associados em relação a outras atividades plug-and-play nos dispositivos pai e irmãos.

Exemplo

NTSTATUS status;
WDFDEVICE Device;
WDFDEVICE child;

// Code to initialize WDFDEVICE objects...

// Remove the child device.
status = AcxDeviceRemoveCircuitDevice(Device, child);

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

Consulte também