Función AcxCircuitInitAssignCategories (acxcircuit.h)
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 que se usa 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.
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 Using NTSTATUS Values.
Observaciones
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 |
|---|---|
| encabezado de | acxcircuit.h |
| irQL | PASSIVE_LEVEL |