EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE fonction de rappel (acxcircuit.h)

  • Article

Le rappel EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE est utilisé par le pilote pour effectuer toute post-initialisation une fois que le point de terminaison composite a été assemblé par ACX Manager.

Syntaxe

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE EvtAcxCircuitCompositeInitialize;

NTSTATUS EvtAcxCircuitCompositeInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CompositeProperties
)
{...}

Paramètres

Device

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

Circuit

Objet ACXCIRCUIT en cours d’initialisation. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

CompositeProperties

Handle facultatif à CompositeProperties qui décrit le circuit composite. Il s’agit d’un objet ACXOBJECTBAG facultatif pour les propriétés du point de terminaison composite.

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

Cet exemple de code montre comment le pilote récupère une propriété composite à partir du sac d’objets de propriété composite spécifié.

EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE CodecR_EvtCircuitCompositeInitialize;

NTSTATUS
CodecR_EvtCircuitCompositeInitialize(
    _In_ WDFDEVICE      Device,
    _In_ ACXCIRCUIT     Circuit,
    _In_ ACXOBJECTBAG   CompositeProperties
    )
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    ASSERT(CompositeProperties);

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
    GUID uniqueId = {0};
    status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);

    // ...

    return status;
}

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