EVT_WDF_DMA_ENABLER_ENABLE fonction de rappel (wdfdmaenabler.h)
[S’applique à KMDF uniquement]
La fonction de rappel d’événement EvtDmaEnablerEnable d’un pilote active la fonctionnalité DMA d’un appareil une fois que l’appareil est entré dans son état de fonctionnement (D0).
Syntaxe
EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;
NTSTATUS EvtWdfDmaEnablerEnable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Paramètres
[in] DmaEnabler
Handle pour un objet d’activation DMA.
Valeur retournée
EvtDmaEnablerEnable doit retourner STATUS_SUCCESS ou une autre valeur de status pour laquelle NT_SUCCESS(status) est égal à TRUE, s’il ne rencontre aucune erreur. Sinon, cette fonction de rappel doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false.
Remarques
Pour inscrire une fonction de rappel EvtDmaEnablerEnable , un pilote de fonction pour un appareil DMA place l’adresse de la fonction de rappel dans une structure WDF_DMA_ENABLER_CONFIG avant que le pilote appelle WdfDmaEnablerCreate.
Pour plus d’informations sur la fonction de rappel EvtDmaEnablerEnable , consultez Prise en charge de la gestion de l’alimentation pour les appareils DMA.
La fonction de rappel EvtDmaEnablerEnable est appelée dans IRQL = PASSIVE_LEVEL. Vous ne devez pas rendre cette fonction de rappel paginable.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfdmaenabler.h (inclure Wdf.h) |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |