Share via

Função AcxCircuitInitAssignComponentUri (acxcircuit.h)

  • Artigo

A função AcxCircuitInitAssignComponentUri atribui uma cadeia de caracteres de URI como ID para o ACXCIRCUIT.

Sintaxe

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

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.

ComponentUri

Uma cadeia de caracteres unicode que descreve o URI que identifica exclusivamente o ACXCIRCUIT.

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

O driver deve inicializar a identidade do circuito definindo seu URI e/ou sua ID (AcxCircuitInitSetComponentId).

Exemplo

O uso de exemplo é mostrado abaixo.

    DECLARE_CONST_UNICODE_STRING(CODEC_CIRCUIT_CAPTURE_URI, L"acx:test:acxcodectestdriver:codec0:circuit0:microphone0");

    // Get a CircuitInit structure.
    //
    circuitInit = AcxCircuitInitAllocate(Device);

    //
    // Add circuit identifiers.
    //
    status = AcxCircuitInitAssignComponentUri(circuitInit, &CODEC_CIRCUIT_CAPTURE_URI);

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