AcxCircuitInitAssignName-Funktion (acxcircuit.h)
Die AcxCircuitInitAssignName-Funktion weist dem ACXCIRCUIT einen Anzeigenamen zu.
Syntax
NTSTATUS AcxCircuitInitAssignName(
PACXCIRCUIT_INIT CircuitInit,
PCUNICODE_STRING CircuitName
);
Parameter
CircuitInit
Die ACXCIRCUIT_INIT Struktur, die die Schaltkreisinitialisierung definiert. ACXCIRCUIT_INIT ist ein undurchsichtiges Objekt, das für die Schaltkreisinitialisierung verwendet wird. Verwenden Sie AcxCircuitInitAllocate, um die ACXCIRCUIT_INIT Struktur zu initialisieren.
CircuitName
Eine Unicode-Zeichenfolge mit dem Schaltkreisnamen, z. B. Microphone0.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Die CircuitName-Zeichenfolge muss mit der INF-Zeichenfolge übereinstimmen, die die Audioschnittstelle identifiziert.
Beispiel
Die Beispielverwendung wird unten gezeigt.
// Circuit Name
DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");
//
// Add circuit identifiers.
//
AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);
AcxCircuitInitAssignName(CircuitInit, &circuitName);
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxcircuit.h |
| IRQL- | PASSIVE_LEVEL |