Condividi tramite

EVT_ACX_FACTORY_CIRCUIT_DELETE_CIRCUITDEVICE funzione di callback (acxcircuit.h)

  • Articolo

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

Vedi anche