EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE funzione di callback (acxcircuit.h)
Il callback EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE viene richiamato da ACX quando il driver deve eliminare un WDFDEVICE creato in precedenza associato a un oggetto ACXCIRCUIT.
Sintassi
EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE EvtAcxFactoryCircuitDeleteCircuitdevice;
NTSTATUS EvtAcxFactoryCircuitDeleteCircuitdevice(
WDFDEVICE Parent,
ACXFACTORYCIRCUIT Factory,
WDFDEVICE Device
)
{...}
Parametri
Parent
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti Framework) che è l'elemento padre del WDFDEVICE a cui fa riferimento nell'oggetto Device.
Factory
Oggetto ACXFACTORYCIRCUIT della fabbrica di circuiti esistente. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
Device
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti Framework) che deve essere eliminato.
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
AcxFactoryCircuit rappresenta un oggetto factory in grado di creare un ACXCIRCUIT su richiesta.
Un driver può registrare uno o più ACXFACTORYCIRCUIT con ACX, questa azione consentirà a ACX di sapere che il driver è in grado di creare ACXCIRCUITs di un tipo ben definito.
ACX richiama i callback di ACXFACTORYCIRCUIT quando rileva che un percorso audio richiede uno degli ACXCIRCUIT forniti dalla factory.
Si tratta di un callback facoltativo, se il callback EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE non è definito, ACX esegue l'azione predefinita di rimuovere il WDFDEVICE specificato dall'elenco di dispositivi enumerati. Questa azione attiva una notifica PnP rimossa a sorpresa nel WDFDEVICE figlio.
L'oggetto ACXFACTORYCIRCUIT supporta acXCIRCUIts dinamici, ciò significa che ogni ACXCIRCUIT creato dalla factory è associato a un WDFDEVICE e questi due oggetti hanno la stessa durata.
AcxFactoryCircuit ha una coda WDF dedicata. Per altre informazioni sulle code WDF, vedere Oggetti coda framework.
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 |