AcxDeviceAddFactoryCircuit-Funktion (acxdevice.h)
Die funktion AcxDeviceAddFactoryCircuit fügt eine Werksschaltung zu einem WDFDEVICE- 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-Factoryschaltung, die dem WDFDEVICE- hinzugefügt werden soll, der durch den parameter Device angegeben wird.
Rückgabewert
AcxDeviceAddFactoryCircuit gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS Fehlercode zurückgegeben.
Bemerkungen
Ein ACX-Treiber kann in den folgenden Szenarien einen oder mehrere Schaltkreise erstellen:
- Zur Initialisierungszeit
- Zur Laufzeit, als Nebeneffekt eines externen Ereignisses, z. B. das Erkennen einer neuen Audiokomponente
- Da es sich selbst bei ACX als Schaltkreisfabrik registriert hat. Das ACX-Framework verwendet die registrierte Factory, um den Treiber aufzufordern, einen neuen Schaltkreis zu erstellen.
Verwenden Sie AcxDeviceRemoveFactoryCircuit-, um einen Werkskreis aus einem WDFDEVICE-zu entfernen.
Diese Funktion kann nur von der 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
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxdevice.h |
| IRQL- | PASSIVE_LEVEL |