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