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.

Retornar valor

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

Comentários

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. 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ão.

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