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

Retornar valor

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

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

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