AcxTargetCircuitCreate, fonction (acxtargets.h)

La fonction AcxTargetCircuitCreate est utilisée pour créer un circuit cible ACX.

Syntaxe

NTSTATUS AcxTargetCircuitCreate(
  WDFDEVICE                  Device,
  PWDF_OBJECT_ATTRIBUTES     Attributes,
  PACX_TARGET_CIRCUIT_CONFIG Config,
  ACXTARGETCIRCUIT           *TargetCircuit
);

Paramètres

Device

Objet WDFDEVICE (décrit dans Résumé des objets Framework) associé à l’ACXCIRCUIT spécifié.

Attributes

Attributs supplémentaires définis à l’aide d’une structure WDF_OBJECT_ATTRIBUTES qui sont utilisés pour définir les valeurs de différents objets : nettoyage et destruction des rappels, type de contexte et pour spécifier son objet parent.

Config

Structure ACX_TARGET_CIRCUIT_CONFIG initialisée qui décrit la configuration du circuit cible.

TargetCircuit

Pointeur vers un emplacement qui reçoit un handle vers le nouvel objet ACXTARGETCIRCUIT. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

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

Exemple

    ACX_TARGET_CIRCUIT_CONFIG targetCfg;
    ACX_TARGET_CIRCUIT_CONFIG_INIT(&targetCfg);
    targetCfg.SymbolicLinkName = link;

    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = Circuit;

    RETURN_NTSTATUS_IF_FAILED(AcxTargetCircuitCreate(AcxCircuitGetWdfDevice(Circuit), &attributes, &targetCfg, TargetCircuit));

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

Voir aussi

• en-tête acxtargets.h