AcxDeviceAddCircuitDevice-Funktion (acxdevice.h)

  • Artikel

Die AcxDeviceAddCircuitDevice-Funktion fügt einem angegebenen übergeordneten Gerät ein ACX-Leitungsgerät hinzu, das einen Audiopfad darstellt.

Syntax

NTSTATUS AcxDeviceAddCircuitDevice(
  WDFDEVICE ParentDevice,
  WDFDEVICE Device
);

Parameter

ParentDevice

Ein WDFDEVICE , der das übergeordnete Element darstellt, dem das Leitungsgerät hinzugefügt wird.

Device

Ein WDFDEVICE , der das Leitungsgerät darstellt, das dem übergeordneten Gerät hinzugefügt werden soll.

Rückgabewert

AcxDeviceAddCircuitDevice gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Audiotreiber verwenden diese Funktion, um einen neuen Audioendpunkt aufzulisten.

Diese Funktion kann während des Lebenszyklus des Fahrers jederzeit aufgerufen werden. Plug & Play serialisiert die Enumeration des Geräts und der zugehörigen Leitungen in Bezug auf andere Plug & Play Aktivitäten auf den übergeordneten und gleichgeordneten Geräten.

Beispiel

WDFDEVICE Device;
WDFDEVICE renderDevice = NULL;
NTSTATUS  status;

// Code to initialize the WDFDEVICE...

// Code to create the WDFDEVICE renderDevice...

//
// Add circuit to device's dynamic circuit device list.
//
status = AcxDeviceAddCircuitDevice(Device, renderDevice);
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