Compartilhar via

Função AcxCircuitInitAssignCategories (acxcircuit.h)

  • Artigo

A função AcxCircuitInitAssignCategories atribui um conjunto de entradas KSCATERGORY para o ACXCIRCUIT.

Sintaxe

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

Parâmetros

CircuitInit

A estrutura ACXCIRCUIT_INIT que define a inicialização do circuito. ACXCIRCUIT_INIT é um objeto opaco usado para inicialização de circuito. Use AcxCircuitInitAllocate para inicializar a estrutura ACXCIRCUIT_INIT.

Categories

Uma matriz que contém GUIDS do KSCATERGORY desejado, por exemplo KSCATEGORY_AUDIO. 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, que se baseia no tipo ACXCIRCUIT.

Exemplo

O uso de exemplo é mostrado abaixo.


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

Versão mínima do ACX: 1.0

Para obter mais informações sobre as 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