AcxDeviceAddCircuit-Funktion (acxdevice.h)
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 |