EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE función de devolución de llamada (acxcircuit.h)

El controlador usa el EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE devolución de llamada para realizar cualquier desinserción de un circuito compuesto cuando ACX Manager la inicializa.

Sintaxis

EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;

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

Parámetros

Device

Objeto WDFDEVICE (descrito en Resumen de objetos de marco) asociado al ACXCIRCUIT especificado.

Circuit

Objeto ACXCIRCUIT que se va a desa inicializar. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

CompositeProperties

Identificador opcional para CircuitProperties. Se trata de un objeto ACXOBJECTBAG opcional para las propiedades de ACXCIRCUIT.

Valor devuelto

None

Observaciones

ACX puede invocar esta devolución de llamada para un ACXCIRCUIT compuesto solo si el WDFDEVICE asociado está presente. Es decir, si el WDFDEVICE asociado se quita por sorpresa (SR), ACX no podrá invocar la devolución de llamada porque sus interfaces PnP asociadas están desactivadas.

Ejemplo

En este código de ejemplo se muestra cómo el controlador recupera una propiedad de circuito del contenedor de objetos de propiedad de circuito especificado.

A continuación se muestra el uso de ejemplo.

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 de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Consulte también

• encabezado acxcircuit.h