Partager 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é-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 dé-initialisé. 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

Aucun

Remarques

ACX est en mesure d’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 minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi