AcxFactoryCircuitInitAssignCategories-Funktion (acxcircuit.h)

  • Artikel

Die AcxFactoryCircuitInitAssignCategories-Funktion weist eine Reihe von Treiberkategorieeinträgen (GUID) für den ACXFACTORYCIRCUIT zu.

Syntax

NTSTATUS AcxFactoryCircuitInitAssignCategories(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  const GUID              *Categories,
  ULONG                   CategoriesCount
);

Parameter

FactoryInit

Eine ACXFACTORYCIRCUIT_INIT-Struktur, die für die Initialisierung der Leitungsfabrik verwendet wird. Dies ist eine undurchsichtige Struktur, die verwendet wird, um AcX Circuit Factory-Initialisierungsinformationen zu speichern und die Factory einem WDF-Gerät zuzuordnen.

Verwenden Sie die AcxFactoryCircuitInitAllocate-Funktion , um die ACXFACTORYCIRCUIT_INIT-Struktur zu initialisieren.

Categories

Ein Array, das GUIDs der gewünschten Gruppe von Treiberkategorieneinträgen enthält. 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 von ACX initialisierten Standardkategoriesatz.

Beispiel

Die Verwendungsbeispiele finden Sie unten.

    ACXFACTORYCIRCUIT                               factory;
    PACXFACTORYCIRCUIT_INIT                         factoryInit = NULL;
    SDCAXU_FACTORYCIRCUIT_CONTEXT *                 factoryCtx;
    ACX_FACTORY_CIRCUIT_OPERATION_CALLBACKS         operationCallbacks;

    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &SDCAXU_FACTORY_GUID);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &SDCAXU_FACTORY_CATEGORY, 1);

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