Partager via

AcxCircuitInitAssignComponentUri, fonction (acxcircuit.h)

  • Article

La fonction AcxCircuitInitAssignComponentUri affecte une chaîne d’URI en tant qu’ID pour l’ACXCIRCUIT.

Syntaxe

NTSTATUS AcxCircuitInitAssignComponentUri(
  PACXCIRCUIT_INIT CircuitInit,
  PCUNICODE_STRING ComponentUri
);

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.

ComponentUri

Chaîne Unicode décrivant l’URI qui identifie de manière unique l’ACXCIRCUIT.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Le pilote doit initialiser l’identité du circuit en définissant son URI et/ou son ID (AcxCircuitInitSetComponentId).

Exemple

L’exemple d’utilisation est illustré ci-dessous.

    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);

Configuration requise pour ACX

Version ACX minimale : 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

Voir aussi