Funzione AcxDeviceAddFactoryCircuit (acxdevice.h)
La funzione AcxDeviceAddFactoryCircuit aggiunge un circuito factory a un WDFDEVICE per la creazione di circuiti audio.
Sintassi
NTSTATUS AcxDeviceAddFactoryCircuit(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory
);
Parametri
Device
WDFDEVICE a cui verrà aggiunto il circuito acX factory.
Factory
Circuito della factory ACX da aggiungere al WDFDEVICE specificato dal parametro Device .
Valore restituito
AcxDeviceAddFactoryCircuit restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS .
Commenti
Un driver ACX può creare uno o più circuiti negli scenari seguenti:
- Al momento dell'inizializzazione
- In fase di esecuzione, come effetto collaterale di un evento esterno, ad esempio il rilevamento di un nuovo componente audio
- Poiché è stato registrato con ACX come fabbrica di circuiti. Il framework ACX usa la factory registrata per chiedere al driver di creare un nuovo circuito.
Usare AcxDeviceRemoveFactoryCircuit per rimuovere un circuito factory da un WDFDEVICE.
Questa funzione può essere chiamata solo dalla funzione di callback EVT_WDF_DEVICE_PREPARE_HARDWARE per questo dispositivo.
Esempio
WDFDEVICE Device;
NTSTATUS status;
PCAPTURE_DEVICE_CONTEXT devCtx;
// Code to initialize WDFDEVICE...
//
// Add control circuit to child's list.
//
status = AcxDeviceAddFactoryCircuit(Device, devCtx->CtrlCircuit);
if (!NT_SUCCESS(status))
{
ASSERT(FALSE);
goto exit;
}
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxdevice.h |
| IRQL | PASSIVE_LEVEL |