EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE función de devolución de llamada (acxcircuit.h)
El controlador usa la EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE devolución de llamada para realizar cualquier desin inicializació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 desins inicializar. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.
CompositeProperties
Identificador opcional de CircuitProperties. Se trata de un objeto ACXOBJECTBAG opcional para las propiedades de ACXCIRCUIT.
Valor devuelto
Ninguno
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
Este código de ejemplo 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
| Requisito | Valor |
|---|---|
| encabezado de | acxcircuit.h |
| irQL | PASSIVE_LEVEL |