AcxDeviceAddFactoryCircuit-Funktion (acxdevice.h)

  • Artikel

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

Weitere Informationen