Compartilhar via

Função AcxDeviceAddCircuitDevice (acxdevice.h)

  • Artigo

A função AcxDeviceAddCircuitDevice adiciona um dispositivo de circuito ACX a um dispositivo pai especificado que representa um caminho de áudio.

Sintaxe

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Parâmetros

ParentDevice

Um WDFDEVICE que representa o pai ao qual o dispositivo de circuito será adicionado.

Device

Um WDFDEVICE que representa o dispositivo de circuito a ser adicionado ao dispositivo pai.

Valor de retorno

AcxDeviceAddCircuitDevice 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 enumerar um novo ponto de extremidade de áudio.

Essa função pode ser chamada a qualquer momento durante o ciclo de vida do driver. O Plug and Play serializa a enumeração do dispositivo e os circuitos associados em relação a outras atividades de Plug and Play nos dispositivos pai e irmãos.

Exemplo

WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS  status;

// Code to initialize the WDFDEVICE...

// Code to create the WDFDEVICE renderDevice...

//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
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