Condividi tramite


Funzione AcxCircuitInitAssignName (acxcircuit.h)

La funzione AcxCircuitInitAssignName assegna un nome descrittivo per ACXCIRCUIT.

Sintassi

NTSTATUS AcxCircuitInitAssignName(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING CircuitName
);

Parametri

CircuitInit

Struttura ACXCIRCUIT_INIT che definisce l'inizializzazione del circuito. ACXCIRCUIT_INIT è un oggetto opaco utilizzato per l'inizializzazione del circuito. Utilizzare AcxCircuitInitAllocate per inizializzare la struttura ACXCIRCUIT_INIT.

CircuitName

Stringa Unicode con il nome del circuito, ad esempio Microphone0.

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 di valori NTSTATUS.

Osservazioni

La stringa CircuitName deve corrispondere alla stringa INF che identifica l'interfaccia audio.

Esempio

Di seguito è riportato un esempio di utilizzo.

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

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

    AcxCircuitInitAssignName(CircuitInit, &circuitName);

Requisiti ACX

versione minima di ACX: 1.0

Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.

Fabbisogno

Requisito Valore
intestazione acxcircuit.h
IRQL PASSIVE_LEVEL

Vedere anche