Compartilhar via

Função AcxCircuitInitAssignName (acxcircuit.h)

  • Artigo

A função AcxCircuitInitAssignName atribui um nome amigável para o ACXCIRCUIT.

Sintaxe

NTSTATUS AcxCircuitInitAssignName(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING CircuitName
);

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.

CircuitName

Uma cadeia de caracteres unicode com o nome do circuito, como Microphone0.

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

A cadeia de caracteres CircuitName deve corresponder à cadeia de caracteres INF que identifica a interface de áudio.

Exemplo

O uso de exemplo é mostrado abaixo.

    // Circuit Name
    DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");

    //
    // Add circuit identifiers.
    //
    AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

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