Share via

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE fonction de rappel (acxcircuit.h)

  • Article

Le rappel EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE est utilisé par le pilote pour effectuer toute dés-initialisation d’un circuit composite lorsqu’il est dé-initialisé par ACX Manager.

Syntaxe

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

void EvtAcxCircuitCompositeDeinitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

Paramètres

Device

Objet WDFDEVICE (décrit dans Summary of Framework Objects) associé à l’ACXCIRCUIT spécifié.

Circuit

Objet ACXCIRCUIT en cours d’initialisation. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

CompositeProperties

Handle facultatif pour CircuitProperties. Il s’agit d’un objet ACXOBJECTBAG facultatif pour les propriétés d’ACXCIRCUIT.

Valeur de retour

None

Remarques

ACX peut appeler ce rappel pour un ACXCIRCUIT composite uniquement si le WDFDEVICE associé est présent. Autrement dit, si le WDFDEVICE associé est supprimé par surprise (SR), ACX ne pourra pas appeler le rappel, car ses interfaces PnP associées sont désactivées.

Exemple

Cet exemple de code montre comment le pilote récupère une propriété de circuit à partir du conteneur d’objets de propriété de circuit spécifié.

L’exemple d’utilisation est illustré ci-dessous.

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

Configuration requise pour ACX

Version ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi