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) padre di WDFDEVICE a cui si fa riferimento nell'oggetto Device.
Factory
Oggetto ACXFACTORYCIRCUIT della factory del circuito 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 di valori NTSTATUS.
Osservazioni
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 informa ACX che il driver è in grado di creare ACXCIRCUIT di un tipo ben definito.
ACX richiama i callback di ACXFACTORYCIRCUIT quando rileva che un percorso audio richiede una delle ACXCIRCUIT fornite 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 al WDFDEVICE figlio.
L'oggetto ACXFACTORYCIRCUIT supporta ACXCIRCUITs dinamico, 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 Framework Queue Objects.
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
Requisito | Valore |
---|---|
intestazione | acxcircuit.h |
IRQL | PASSIVE_LEVEL |