Funzione AcxCircuitInitAssignComponentUri (acxcircuit.h)
La funzione AcxCircuitInitAssignComponentUri assegna una stringa URI come ID per ACXCIRCUIT.
Sintassi
NTSTATUS AcxCircuitInitAssignComponentUri(
PACXCIRCUIT_INIT CircuitInit,
PCUNICODE_STRING ComponentUri
);
Parametri
CircuitInit
Struttura ACXCIRCUIT_INIT che definisce l'inizializzazione del circuito. ACXCIRCUIT_INIT è un oggetto opaco utilizzato per l'inizializzazione del circuito. Usare AcxCircuitInitAllocate per inizializzare la struttura ACXCIRCUIT_INIT.
ComponentUri
Stringa Unicode che descrive l'URI che identifica in modo univoco ACXCIRCUIT.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Il driver deve inizializzare l'identità del circuito impostandone l'URI e/o il relativo ID (AcxCircuitInitSetComponentId).
Esempio
Di seguito è riportato un esempio di utilizzo.
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);
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |