Funzione AcxDeviceRemoveFactoryCircuit (acxdevice.h)

Articolo
01/07/2025

La funzione AcxDeviceRemoveFactoryCircuit rimuove un circuito factory per la creazione di circuiti audio da un WDFDEVICE.

Sintassi

NTSTATUS AcxDeviceRemoveFactoryCircuit(
  WDFDEVICE         Device,
  ACXFACTORYCIRCUIT Factory
);

Parametri

Device

WDFDEVICE da cui verrà rimosso il circuito di fabbrica ACX.

Factory

Circuito di fabbrica ACX da rimuovere dal WDFDEVICE specificato dal parametro Device .

Valore restituito

acxDeviceRemoveFactoryCircuit restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un NTSTATUS codice di errore.

Osservazioni

Un driver tipico non dovrà chiamare AcxDeviceRemoveFactoryCircuit. Questa funzione non deve essere chiamata se il circuito factory ha creato dispositivi del circuito ancora attivi.

Se un driver decide di chiamare questa funzione per un circuito di fabbrica, il driver diventa responsabile della prima rimozione dei dispositivi del circuito creati tramite il circuito factory associato, prima diviene chiamato AcxDeviceRemoveFactoryCircuit.

Per altre informazioni sull'uso dei circuiti, vedere di rimozione dinamica del circuito ACX e 'enumerazione del dispositivo ACX.

Questa funzione può essere chiamata solo dalla funzione di callback EVT_WDF_DEVICE_RELEASE_HARDWARE per questo dispositivo.

Usare AcxDeviceAddFactoryCircuit per aggiungere un circuito factory a un WDFDEVICE.

Requisiti ACX

versione minima di ACX: 1.0

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

Fabbisogno

Requisito	Valore
intestazione	acxdevice.h
IRQL	PASSIVE_LEVEL

Condividi tramite