Partilhar via

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

  • Artigo

O retorno de chamada EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE é usado pelo driver para fazer qualquer desinicialização de um circuito composto quando ele é desinicializado pelo GERENCIADOr ACX.

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 de Estrutura) associado ao ACXCIRCUIT especificado.

Circuit

O objeto ACXCIRCUIT que está sendo desinicializado. 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 de ACXCIRCUIT.

Retornar valor

Nenhum

Comentários

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 SR (removido surpresa), 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

Confira também