AcxCircuitInitAssignName-Funktion (acxcircuit.h)

  • Artikel

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 Verbindungsinitialisierung definiert. ACXCIRCUIT_INIT ist ein undurchsichtiges Objekt, das für die Verbindungsinitialisierung verwendet wird. Verwenden Sie AcxCircuitInitAllocate , um die ACXCIRCUIT_INIT-Struktur zu initialisieren.

CircuitName

Eine Unicode-Zeichenfolge mit dem Leitungsnamen, z. B . Microphone0.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Hinweise

Die CircuitName-Zeichenfolge muss mit der INF-Zeichenfolge übereinstimmen, die die Audioschnittstelle identifiziert.

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

    // Circuit Name
    DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

ACX-Anforderungen

ACX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Weitere Informationen