AcxCircuitInitAssignCategories-Funktion (acxcircuit.h)
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 |