EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE funzione di callback (acxcircuit.h)

Il callback EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE viene usato dal driver per eseguire qualsiasi de-inizializzazione di un circuito composito quando viene de-inizializzato da ACX Manager.

Sintassi

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

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

Parametri

Device

Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti Framework) associato all'oggetto ACXCIRCUIT specificato.

Circuit

Oggetto ACXCIRCUIT de inizializzato. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

CompositeProperties

Handle facoltativo in CircuitProperties. Si tratta di un oggetto ACXOBJECTBAG facoltativo per le proprietà di ACXCIRCUIT.

Valore restituito

nessuno

Osservazioni

ACX è in grado di richiamare questo callback per un ACXCIRCUIT composito solo se è presente il WDFDEVICE associato. Ovvero, se il WDFDEVICE associato è rimosso a sorpresa (SR), ACX non sarà in grado di richiamare il callback perché le interfacce PnP associate vengono disattivate.

Esempio

Questo codice di esempio illustra come il driver recupera una proprietà del circuito dall'oggetto oggetto proprietà circuito specificato.

Di seguito è riportato l'esempio di utilizzo.

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

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Vedi anche

• intestazione acxcircuit.h