Share via

Función AcxCircuitInitAssignCategories (acxcircuit.h)

  • Artículo

La función AcxCircuitInitAssignCategories asigna un conjunto de entradas KSCATERGORY para ACXCIRCUIT.

Sintaxis

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

Parámetros

CircuitInit

Estructura ACXCIRCUIT_INIT que define la inicialización del circuito. ACXCIRCUIT_INIT es un objeto opaco utilizado para la inicialización del circuito. Use AcxCircuitInitAllocate para inicializar la estructura de ACXCIRCUIT_INIT.

Categories

Matriz que contiene GUIDS del KSCATERGORY deseado, por ejemplo KSCATEGORY_AUDIO. Para obtener más información sobre las entradas KSCATERGORY, consulte Instalación de interfaces de dispositivo para un adaptador de audio.

CategoriesCount

Número de categorías que se agregarán al circuito. Se trata de un recuento basado en uno.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Esta llamada invalida el conjunto de categorías predeterminado inicializado por ACX que se basa en el tipo ACXCIRCUIT.

Ejemplo

A continuación se muestra el uso de ejemplo.


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

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Consulte también