AcxDeviceAddFactoryCircuit-Funktion (acxdevice.h)
Die AcxDeviceAddFactoryCircuit-Funktion fügt einem WDFDEVICE eine Werksschaltung zum Erstellen von Audioschaltungen hinzu.
Syntax
NTSTATUS AcxDeviceAddFactoryCircuit(
WDFDEVICE Device,
ACXFACTORYCIRCUIT Factory
);
Parameter
Device
Ein WDFDEVICE , dem die ACX-Werksschaltung hinzugefügt wird.
Factory
Die ACX-Werksschaltung, die dem durch den Device-Parameter angegebenen WDFDEVICE hinzugefügt werden soll.
Rückgabewert
AcxDeviceAddFactoryCircuit gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.
Hinweise
Ein ACX-Treiber kann in den folgenden Szenarien eine oder mehrere Leitungen erstellen:
- Zur Initialisierungszeit
- Zur Laufzeit als Nebeneffekt eines externen Ereignisses, z. B. erkennen einer neuen Audiokomponente
- Weil es sich bei ACX als Circuit Factory registriert hat. Das ACX-Framework verwendet die registrierte Factory, um den Treiber aufzufordern, eine neue Verbindung zu erstellen.
Verwenden Sie AcxDeviceRemoveFactoryCircuit , um eine Werksschaltung aus einem WDFDEVICE zu entfernen.
Diese Funktion kann nur über die EVT_WDF_DEVICE_PREPARE_HARDWARE Rückruffunktion für dieses Gerät aufgerufen werden.
Beispiel
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;
}
ACX-Anforderungen
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxdevice.h |
| IRQL | PASSIVE_LEVEL |