Share via

Função AcxFactoryCircuitInitAssignCategories (acxcircuit.h)

  • Artigo

A função AcxFactoryCircuitInitAssignCategories atribui um conjunto de entradas guid (categoria de driver) para o ACXFACTORYCIRCUIT.

Sintaxe

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

Parâmetros

FactoryInit

Uma estrutura ACXFACTORYCIRCUIT_INIT usada para inicialização de fábrica de circuitos. Essa é uma estrutura opaca usada para armazenar informações de inicialização de fábrica do Circuito ACX e associar a fábrica a um dispositivo WDF.

Use a função AcxFactoryCircuitInitAllocate para inicializar a estrutura ACXFACTORYCIRCUIT_INIT.

Categories

Uma matriz que contém GUIDs do conjunto desejado de entradas de categoria de driver. Para obter mais informações sobre as entradas KSCATERGORY, consulte Instalando interfaces de dispositivo para um adaptador de áudio.

CategoriesCount

O número de categorias que serão adicionadas ao circuito. Esta é uma contagem baseada em um.

Retornar valor

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Comentários

Essa chamada substitui o conjunto de categorias padrão inicializado pelo ACX.

Exemplo

O uso de exemplo é mostrado abaixo.

    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 do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxcircuit.h
IRQL PASSIVE_LEVEL

Confira também