EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE fonction de rappel (acxcircuit.h)

  • Article

Le rappel EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE est utilisé par le pilote pour effectuer toute initialisation d’un circuit composite lorsqu’il est détecté et initialisé par ACX Manager.

Syntaxe

EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE EvtAcxCircuitCompositeCircuitInitialize;

NTSTATUS EvtAcxCircuitCompositeCircuitInitialize(
  WDFDEVICE Device,
  ACXCIRCUIT Circuit,
  ACXOBJECTBAG CircuitProperties
)
{...}

Paramètres

Device

Objet WDFDEVICE (décrit dans Summary of Framework Objects) 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.

CircuitProperties

Handle facultatif pour CircuitProperties. Il s’agit d’un objet ACXOBJECTBAG facultatif pour les propriétés d’ACXCIRCUIT.

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

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

DspR_EvtCircuitCompositeCircuitInitialize(
    _In_     WDFDEVICE      Device,
    _In_     ACXCIRCUIT     Circuit,
    _In_opt_ ACXOBJECTBAG   CircuitProperties
    )
{
    NTSTATUS status = STATUS_SUCCESS;

    PAGED_CODE();
    
    UNREFERENCED_PARAMETER(Device);
    UNREFERENCED_PARAMETER(Circuit);

    if (CircuitProperties != NULL)
    {
        DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(msft, TestUI4);
        ULONG testUI4;

        status = AcxObjectBagRetrieveUI4(CircuitProperties, &TestUI4, &testUI4);
        if (!NT_SUCCESS(status))
        {
            // Log error.
            goto exit;
        }

        //...
    }
    
    //...

    // All done.
    status = STATUS_SUCCESS;

exit:
    return status;
}

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

Voir aussi