Função AcxCircuitInitAssignComponentUri (acxcircuit.h)
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 do circuito. Use AcxCircuitInitAllocate para inicializar a estrutura de ACXCIRCUIT_INIT.
ComponentUri
Uma cadeia de caracteres unicode que descreve o URI que identifica exclusivamente o ACXCIRCUIT.
Valor de retorno
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.
Observações
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 versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |