EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE função de retorno de chamada (acxcircuit.h)
O EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE retorno de chamada é usado pelo driver para fazer qualquer des inicialização de um circuito composto quando ele é des inicializado pelo ACX Manager.
Sintaxe
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;
void EvtAcxCircuitCompositeDeinitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CompositeProperties
)
{...}
Parâmetros
Device
Um objeto WDFDEVICE (descrito em Resumo de Objetos da Estrutura) associado ao ACXCIRCUIT especificado.
Circuit
O objeto ACXCIRCUIT que está sendo des inicializado. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.
CompositeProperties
Identificador opcional para CircuitProperties. Este é um objeto ACXOBJECTBAG opcional para as propriedades do ACXCIRCUIT.
Valor de retorno
Nenhum
Observações
O ACX poderá invocar esse retorno de chamada para um ACXCIRCUIT composto somente se o WDFDEVICE associado estiver presente. Ou seja, se o WDFDEVICE associado for removido de surpresa (SR), o ACX não poderá invocar o retorno de chamada porque suas interfaces PnP associadas estão desativadas.
Exemplo
Este código de exemplo mostra como o driver recupera uma propriedade de circuito do recipiente de objetos de propriedade do circuito especificado.
O uso de exemplo é mostrado abaixo.
VOID
DspR_EvtCircuitCompositeDeinitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_opt_ ACXOBJECTBAG CompositeProperties
)
{
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
NTSTATUS status = STATUS_SUCCESS;
GUID uniqueId = {0};
PAGED_CODE();
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
if (CompositeProperties)
{
status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
if (!NT_SUCCESS(status))
{
// Log error.
}
}
}
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 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |