AcxCircuitInitAssignCategories-Funktion (acxcircuit.h)

  • Artikel

Die AcxCircuitInitAssignCategories-Funktion weist eine Reihe von KSCATERGORY-Einträgen für den ACXCIRCUIT zu.

Syntax

NTSTATUS AcxCircuitInitAssignCategories(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *Categories,
  ULONG            CategoriesCount
);

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.

Categories

Ein Array, das GUIDS des gewünschten KSCATERGORY enthält, z. B KSCATEGORY_AUDIO. . Weitere Informationen zu den KSCATERGORY-Einträgen finden Sie unter Installieren von Geräteschnittstellen für einen Audioadapter.

CategoriesCount

Die Anzahl der Kategorien, die der Verbindung hinzugefügt werden. Dies ist eine einsbasierte Anzahl.

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

Dieser Aufruf überschreibt den Standardkategoriesatz, der von ACX initialisiert wird und auf dem ACXCIRCUIT-Typ basiert.

Beispiel

Die Verwendungsbeispiele finden Sie unten.


    GUID captureCategories[] =
    {
        STATICGUIDOF(KSCATEGORY_AUDIO),
        STATICGUIDOF(KSCATEGORY_CAPTURE), 
        STATICGUIDOF(KSCATEGORY_REALTIME),
        STATICGUIDOF(KSCATEGORY_TOPOLOGY),
    };

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

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

    status = AcxCircuitInitAssignCategories(CircuitInit, captureCategories, SIZEOF_ARRAY(captureCategories));

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