Partager via


AcxFactoryCircuitInitAssignComponentUri, fonction (acxcircuit.h)

La fonction AcxFactoryCircuitInitAssignComponentUri affecte une chaîne d’URI comme identificateur pour le CIRCUIT ACXFACTORY.

Syntaxe

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

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.

ComponentUri

Chaîne unicode qui décrit le composant.

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

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

Exemple

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

    DECLARE_CONST_UNICODE_STRING(dspFactoryName, L"DspFactoryCircuit");
    DECLARE_CONST_UNICODE_STRING(dspFactoryUri, L"URI_Goes_Here");

    //
    // Get a FactoryCircuitInit structure.
    //
    PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    status = cxFactoryCircuitInitAssignComponentUri(factoryInit, &dspFactoryUri);
    status = AcxFactoryCircuitInitAssignName(factoryInit, &dspFactoryName);

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

Voir aussi