Share via

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE função de retorno de chamada (acxcircuit.h)

  • Artigo

O retorno de chamada EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE é invocado pelo ACX quando o driver deve excluir um WDFDEVICE criado anteriormente associado a um objeto ACXCIRCUIT.

Sintaxe

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;

NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
  WDFDEVICE Parent,
  ACXFACTORYCIRCUIT Factory,
  WDFDEVICE Device
)
{...}

Parâmetros

Parent

Um objeto WDFDEVICE (descrito em Resumo de Objetos framework) que é o pai do WDFDEVICE referenciado no objeto Device.

Factory

O objeto ACXFACTORYCIRCUIT da fábrica de circuitos existente. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

Device

Um objeto WDFDEVICE (descrito em Resumo de Objetos framework) que deve ser excluído.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Um AcxFactoryCircuit representa um objeto de fábrica capaz de criar um ACXCIRCUIT sob demanda.

Um driver pode registrar um ou mais ACXFACTORYCIRCUIT com ACX, essa ação permitirá que o ACX saiba que o driver é capaz de criar ACXCIRCUITs de um tipo bem definido.

O ACX invoca os retornos de chamada do ACXFACTORYCIRCUIT quando detecta que um caminho de áudio requer um dos ACXCIRCUITs fornecidos pela fábrica.

Esse é um retorno de chamada opcional, se o retorno de chamada EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE não estiver definido, o ACX tomará a ação padrão de remover o WDFDEVICE especificado da lista de dispositivos enumerados. Essa ação dispara uma notificação PnP removida de surpresa para o WDFDEVICE filho.

O objeto ACXFACTORYCIRCUIT dá suporte a ACXCIRCUITs dinâmicos, isso significa que cada ACXCIRCUIT criado pela fábrica está associado a um WDFDEVICE e esses dois objetos têm o mesmo tempo de vida.

Um AcxFactoryCircuit tem uma fila WDF dedicada. Para obter mais informações sobre filas do WDF, consulte Objetos de Fila da Estrutura.

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 acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também