Partager via

AcxCircuitInitAssignCategories, fonction (acxcircuit.h)

  • Article

La fonction AcxCircuitInitAssignCategories affecte un ensemble d’entrées KSCATERGORY pour 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 de 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.

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, 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 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

Voir aussi