AcxDeviceAddCircuit-Funktion (acxdevice.h)

2025-02-06

Die funktion AcxDeviceAddCircuit fügt einer WDFDEVICE- einen ACX-Schaltkreis hinzu, um einen Audioendpunkt zu erstellen.

Syntax

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parameter

Device

Eine WDFDEVICE-, die das Gerät darstellt, dem der Schaltkreis hinzugefügt wird.

Circuit

Der Schaltkreis, der dem Devicehinzugefügt werden soll.

Rückgabewert

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

Bemerkungen

Die Audioschaltung ist der Kernbaustein von ACX. Ein Audiotreiber erstellt ein oder mehrere ACX-Schaltkreisobjekte, um einen teilweisen oder vollständigen Audiodaten- und Steuerpfad darzustellen. ACX fasst diese ACX-Schaltkreisobjekte zusammen, um einen vollständigen Audiopfad zu erstellen, der einen Audioendpunkt darstellt.

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;
PCODEC_DEVICE_CONTEXT devCtx;

// Code to initialize the WDFDEVICE...

devCtx = GetCodecDeviceContext(Device);
ASSERT(devCtx != NULL);

//
// Add static circuit to device's list.
//
ASSERT(devCtx->Render);
status = AcxDeviceAddCircuit(Device, devCtx->Render);

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

Freigeben über