AcxDeviceAddCircuit-Funktion (acxdevice.h)

  • Artikel

Die AcxDeviceAddCircuit-Funktion fügt einem WDFDEVICE eine ACX-Verbindung hinzu, um einen Audioendpunkt zu erstellen.

Syntax

NTSTATUS AcxDeviceAddCircuit(
  WDFDEVICE  Device,
  ACXCIRCUIT Circuit
);

Parameter

Device

Ein WDFDEVICE,das das Gerät darstellt, dem die Verbindung hinzugefügt wird.

Circuit

Die Verbindung, die dem Gerät hinzugefügt werden soll.

Rückgabewert

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

Hinweise

Die Audioschaltung ist der Kernbaustein von ACX. Ein Audiotreiber erstellt mindestens ein ACX-Leitungsobjekt, um einen teilweisen oder vollständigen Audiodaten- und Steuerungspfad darzustellen. ACX stellt diese ACX-Leitungsobjekte zusammen, um einen vollständigen Audiopfad zu erstellen, der einen Audioendpunkt darstellt.

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

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