Funzione AcxFactoryCircuitInitAssignCategories (acxcircuit.h)
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 utilizzata per l'inizializzazione della factory del circuito. Si tratta di una struttura opaca usata per archiviare le informazioni di inizializzazione della factory del circuito ACX e associare la factory a un dispositivo WDF.
Utilizzare la funzione AcxFactoryCircuitInitAllocate per inizializzare la struttura ACXFACTORYCIRCUIT_INIT.
Categories
Matrice che contiene GUID del set desiderato di voci della categoria di driver. Per altre informazioni sulle voci KSCATERGORY, vedere Installing Device Interfaces for an Audio Adapter.
CategoriesCount
Numero di categorie che verranno aggiunte al circuito. Si tratta di un conteggio basato su un solo.
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 di valori NTSTATUS.
Osservazioni
Questa chiamata esegue l'override del set di categorie predefinito inizializzato da ACX.
Esempio
Di seguito è riportato un 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 di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |