Share via

Función AcxFactoryCircuitInitAssignCategories (acxcircuit.h)

  • Artículo

La función AcxFactoryCircuitInitAssignCategories asigna un conjunto de entradas de categoría de controlador (GUID) para ACXFACTORYCIRCUIT.

Sintaxis

NTSTATUS AcxFactoryCircuitInitAssignCategories(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  const GUID              *Categories,
  ULONG                   CategoriesCount
);

Parámetros

FactoryInit

Estructura ACXFACTORYCIRCUIT_INIT que se usa para la inicialización del generador de circuitos. Se trata de una estructura opaca que se usa para almacenar la información de inicialización de fábrica del circuito ACX y asociar la fábrica a un dispositivo WDF.

Use la función AcxFactoryCircuitInitAllocate para inicializar la estructura de ACXFACTORYCIRCUIT_INIT.

Categories

Matriz que contiene GUID del conjunto deseado de entradas de categoría de controlador. 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 Uso de valores NTSTATUS.

Comentarios

Esta llamada invalida el conjunto de categorías predeterminado inicializado por ACX.

Ejemplo

A continuación se muestra un ejemplo de uso.

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

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