Condividi tramite

Funzione AcxFactoryCircuitInitAssignCategories (acxcircuit.h)

  • Articolo

La funzione AcxFactoryCircuitInitAssignCategories assegna un set di voci di categoria driver (GUID) per ACXFACTORYCIRCUIT.

Sintassi

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

Parametri

FactoryInit

Struttura ACXFACTORYCIRCUIT_INIT usata per l'inizializzazione della factory del circuito. Si tratta di una struttura opaca usata per archiviare le informazioni di inizializzazione della fabbrica di circuiti ACX e associare la factory a un dispositivo WDF.

Usare la funzione AcxFactoryCircuitInitAllocate per inizializzare la struttura di ACXFACTORYCIRCUIT_INIT.

Categories

Matrice che contiene GUID del set desiderato di voci di categoria di driver. Per altre informazioni sulle voci KSCATERGORY, vedere Installazione di interfacce dispositivo per un adattatore audio.

CategoriesCount

Numero di categorie che verranno aggiunte al circuito. Si tratta di un conteggio basato.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Questa chiamata esegue l'override del set di categorie predefinito inizializzato da ACX.

Esempio

Di seguito è riportato l'esempio di utilizzo.

    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);

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxcircuit.h
IRQL PASSIVE_LEVEL

Vedi anche