Fonction AcxCircuitInitAssignName (acxcircuit.h)
La fonction AcxCircuitInitAssignName attribue un nom convivial à l’OBJET ACXCIRCUIT.
Syntaxe
NTSTATUS AcxCircuitInitAssignName(
PACXCIRCUIT_INIT CircuitInit,
PCUNICODE_STRING CircuitName
);
Paramètres
CircuitInit
Structure ACXCIRCUIT_INIT qui définit l’initialisation du circuit. ACXCIRCUIT_INIT est un objet opaque utilisé pour l’initialisation du circuit. Utilisez AcxCircuitInitAllocate pour initialiser la structure ACXCIRCUIT_INIT.
CircuitName
Chaîne unicode avec le nom de circuit, par exemple Microphone0.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
La chaîne CircuitName doit correspondre à la chaîne INF qui identifie l’interface audio.
Exemple
L’exemple d’utilisation est illustré ci-dessous.
// Circuit Name
DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");
//
// Add circuit identifiers.
//
AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);
AcxCircuitInitAssignName(CircuitInit, &circuitName);
Configuration requise d’ACX
Version minimale d’ACX : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |