EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE função de retorno de chamada (acxcircuit.h)
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 |