Fonction AcxFactoryCircuitInitAssignName (acxcircuit.h)

La fonction AcxFactoryCircuitInitAssignName attribue un nom convivial à l’ACXFACTORYCIRCUIT.

Syntaxe

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

Paramètres

FactoryInit

Structure ACXFACTORYCIRCUIT_INIT utilisée pour l’initialisation de la fabrique de circuits. Il s’agit d’une structure opaque utilisée pour stocker les informations d’initialisation de la fabrique du circuit ACX et associer la fabrique à un appareil WDF.

Utilisez la fonction AcxFactoryCircuitInitAllocate pour initialiser la structure ACXFACTORYCIRCUIT_INIT.

FactoryName

Chaîne unicode avec le nom de la fabrique de circuit, par exemple Factory_Microphone.

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

Exemple

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

//
// Factory Name.
//
DECLARE_CONST_UNICODE_STRING(s_FactoryName, L"Render");
    
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
    AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);

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

Voir aussi

• en-tête acxcircuit.h