Partager via


Fonction AcxCircuitInitAssignCategories (acxcircuit.h)

La fonction AcxCircuitInitAssignCategories affecte un ensemble d’entrées KSCATERGORY pour l’ACXCIRCUIT.

Syntaxe

NTSTATUS AcxCircuitInitAssignCategories(
  PACXCIRCUIT_INIT CircuitInit,
  const GUID       *Categories,
  ULONG            CategoriesCount
);

Paramètres

CircuitInit

Structure ACXCIRCUIT_INIT qui définit l’initialisation du circuit. ACXCIRCUIT_INIT est un objet opaque utilisé pour l’initialisation du circuit. Utilisez AcxCircuitInitAllocate pour initialiser la structure ACXCIRCUIT_INIT.

Categories

Tableau qui contient des GUID du KSCATERGORY souhaité, par exemple KSCATEGORY_AUDIO. 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 seul.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Cet appel remplace le jeu de catégories par défaut initialisé par ACX qui est basé sur le type ACXCIRCUIT.

Exemple

L’exemple d’utilisation est illustré ci-dessous.


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

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi