AcxFactoryCircuitInitAssignCategories, fonction (acxcircuit.h)
La fonction AcxFactoryCircuitInitAssignCategories affecte un ensemble d’entrées de catégorie de pilote (GUID) pour ACXFACTORYCIRCUIT.
Syntaxe
NTSTATUS AcxFactoryCircuitInitAssignCategories(
PACXFACTORYCIRCUIT_INIT FactoryInit,
const GUID *Categories,
ULONG CategoriesCount
);
Paramètres
FactoryInit
Structure ACXFACTORYCIRCUIT_INIT utilisée pour l’initialisation d’usine de circuit. Il s’agit d’une structure opaque utilisée pour stocker les informations d’initialisation des fabriques de circuit ACX et associer la fabrique à un appareil WDF.
Utilisez la fonction AcxFactoryCircuitInitAllocate pour initialiser la structure ACXFACTORYCIRCUIT_INIT.
Categories
Tableau qui contient des GUID de l’ensemble souhaité d’entrées de catégorie de pilote. Pour plus d’informations sur les entrées KSCATERGORY, consultez Installation d’interfaces d’appareil pour une carte audio.
CategoriesCount
Nombre de catégories qui seront ajoutées au circuit. Il s’agit d’un nombre basé sur un.
Valeur de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Cet appel remplace le jeu de catégories par défaut initialisé par ACX.
Exemple
L’exemple d’utilisation est illustré ci-dessous.
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);
Configuration requise pour ACX
version minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |