EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE Rückruffunktion (acxcircuit.h)

  • Artikel

Der EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE-Rückrufs wird vom Treiber verwendet, um die Initialisierung einer zusammengesetzten Verbindung zu entfernen, wenn sie vom ACX-Manager initialisiert wird.

Syntax

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

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

Parameter

Device

Ein WDFDEVICE-Objekt (beschrieben in Summary of Framework Objects), das dem angegebenen ACXCIRCUIT zugeordnet ist.

Circuit

Das ACXCIRCUIT-Objekt, das deinitialisiert wird. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung von ACX-Objekten.

CompositeProperties

Optionales Handle für CircuitProperties. Dies ist ein optionales ACXOBJECTBAG-Objekt für die ACXCIRCUIT-Eigenschaften.

Rückgabewert

Keine

Bemerkungen

ACX kann diesen Rückruf für eine zusammengesetzte ACXCIRCUIT-Instanz nur aufrufen, wenn das zugeordnete WDFDEVICE vorhanden ist. Das heißt, wenn das zugeordnete WDFDEVICE überraschend entfernt (SR) ist, kann ACX den Rückruf nicht aufrufen, da die zugeordneten PnP-Schnittstellen deaktiviert sind.

Beispiel

Dieser Beispielcode zeigt, wie der Treiber eine Leitungseigenschaft aus dem angegebenen Leitungseigenschaftsobjektbehälter abruft.

Das Beispiel für die Verwendung ist unten dargestellt.

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

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Weitere Informationen