Partager via

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 une 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 initialisé. 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 de retour

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.

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 minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxcircuit.h
IRQL PASSIVE_LEVEL

Voir aussi