Condividi tramite

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE funzione di callback (acxcircuit.h)

  • Articolo

Il callback EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE viene usato dal driver per aggiungere funzionalità quando un ACXFACTORYCIRCUIT si trova nella fase hardware di rilascio.

Sintassi

EVT_ACX_FACTORY_CIRCUIT_RELEASE_HARDWARE EvtAcxFactoryCircuitReleaseHardware;

NTSTATUS EvtAcxFactoryCircuitReleaseHardware(
  WDFDEVICE Device,
  ACXFACTORYCIRCUIT Factory,
  WDFCMRESLIST ResourcesTranslated
)
{...}

Parametri

Device

Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti Framework) associato al circuito ACX.

Factory

Oggetto ACXFACTORYCIRCUIT della fabbrica di circuiti esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

ResourcesTranslated

Elenco di risorse WDF che descrive le risorse tradotte da usare per la fase di preparazione dell'hardware. Si tratta di un oggetto elenco risorse del framework WDF che rappresenta un elenco di risorse hardware per un dispositivo. Per altre informazioni sugli elenchi di risorse tradotti, vedere Risorse non elaborate e tradotte.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Per registrare una funzione di callback EvtAcxFactoryCircuitReleaseHardware, il driver deve chiamare AcxFactoryCircuitInitSetAcxCircuitPnpPowerCallbacks.

Se un driver ha registrato una funzione di callback EvtAcxFactoryCircuitReleaseHardware, il framework lo chiama durante le transizioni seguenti:

  • Ribilanciamento delle risorse
  • Rimozione ordinata
  • Rimozione delle sorprese

Il framework ACX chiama la funzione di callback EvtAcxFactoryCircuitReleaseHardware dopo che il framework WDF ha interrotto l'invio di richieste di I/O al dispositivo, eventuali interruzioni assegnate al dispositivo sono state disabilitate e disconnesse e il dispositivo è stato disattivato.

Il framework ACX chiama la funzione di callback EvtAcxFactoryCircuitReleaseHardware prima che il framework WDF chiami la funzione di callback EvtDeviceReleaseHardware del driver.

Quando il framework chiama l'oggetto EvtAcxFactoryCircuitReleaseHardware il PDO per il dispositivo esiste ancora e può essere sottoposto a query per le informazioni sul dispositivo disponibili nello stato disattivato, ad esempio lo stato di configurazione PCI.

Inoltre, le risorse hardware tradotte fornite dal framework a EvtDeviceReleaseHardware sono ancora assegnate al dispositivo. Lo scopo principale di questa funzione di callback consiste nel rilasciare tali risorse e in particolare per annullare il mapping di tutte le risorse di memoria mappate dalla funzione di callback evtAcxCircuitPrepareHardware del driver. Il driver può anche usare questo callback per eseguire qualsiasi altra attività di gestione ACXCIRCUIT che potrebbe essere necessaria nello stato di accensione. In genere, tutte le altre operazioni di arresto hardware devono essere eseguite nella funzione di callback EvtDeviceD0Exit del driver.

Il framework ACX chiama sempre la funzione di callback EvtAcxFactoryCircuitReleaseHardware del driver se la funzione di callback evtAcxFactoryCircuitPrepareHardware del driver è stata chiamata, a meno che il callback evtAcxFactoryCircuitPrepareHardware abbia restituito un codice di errore.

Per altre informazioni su quando il framework ACX e WDF chiamano queste funzioni di callback, vedere Scenari di PnP e Power Management.

Per altre informazioni sulle risorse hardware, vedere Introduzione alle risorse hardware.

Per altre informazioni sui driver che forniscono questa funzione di callback, vedere Supporto di PnP e Power Management in Driver di funzione.

Requisiti ACX

Versione minima DI ACX: 1.0

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

Requisiti

Requisito Valore
Intestazione acxcircuit.h
IRQL PASSIVE_LEVEL

Vedi anche