Condividi tramite


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

Vedere anche