AcxCircuitInitAssignComponentUri-Funktion (acxcircuit.h)

  • Artikel

Die AcxCircuitInitAssignComponentUri-Funktion weist eine URI-Zeichenfolge als ID für den ACXCIRCUIT zu.

Syntax

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

Parameter

CircuitInit

Die ACXCIRCUIT_INIT-Struktur, die die Leitungsinitialisierung definiert. ACXCIRCUIT_INIT ist ein undurchsichtiges Objekt, das für die Leitungsinitialisierung verwendet wird. Verwenden Sie AcxCircuitInitAllocate , um die ACXCIRCUIT_INIT-Struktur zu initialisieren.

ComponentUri

Eine Unicode-Zeichenfolge, die den URI beschreibt, der den ACXCIRCUIT eindeutig identifiziert.

Rückgabewert

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

Hinweise

Der Treiber muss die Identität der Verbindung initialisieren, indem er seinen URI und/oder seine ID (AcxCircuitInitSetComponentId) festlegt.

Beispiel

Die Verwendungsbeispiele finden Sie unten.

    DECLARE_CONST_UNICODE_STRING(CODEC_CIRCUIT_CAPTURE_URI, L"acx:test:acxcodectestdriver:codec0:circuit0:microphone0");

    // Get a CircuitInit structure.
    //
    circuitInit = AcxCircuitInitAllocate(Device);

    //
    // Add circuit identifiers.
    //
    status = AcxCircuitInitAssignComponentUri(circuitInit, &CODEC_CIRCUIT_CAPTURE_URI);

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