fonction de rappel EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE (acxcircuit.h)
Le rappel EVT_ACX_CIRCUIT_COMPOSITE_INITIALIZE est utilisé par le pilote pour effectuer une post-initialisation après l’assemblage du point de terminaison composite 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 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.
CompositeProperties
Handle facultatif vers 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 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é composite à partir du conteneur 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 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 |