EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_INITIALIZE fonction de rappel (acxcircuit.h)
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 |