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
| Condition requise | Valeur |
|---|---|
| En-tête | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |