EVT_WDF_DMA_ENABLER_FILL fonction de rappel (wdfdmaenabler.h)
[S’applique uniquement à KMDF]
La fonction de rappel d’événement EvtDmaEnablerFill d’un pilote alloue les mémoires tampons DMA d’un appareil.
Syntaxe
EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;
NTSTATUS EvtWdfDmaEnablerFill(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Paramètres
[in] DmaEnabler
Handle d’un objet d’activation DMA.
Valeur retournée
EvtDmaEnablerFill doit retourner STATUS_SUCCESS ou une autre valeur 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 EvtDmaEnablerFill , 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 n’appelle WdfDmaEnablerCreate.
Pour plus d’informations sur la fonction de rappel EvtDmaEnablerFill , consultez Prise en charge de la gestion de l’alimentation pour les appareils DMA.
La fonction de rappel EvtDmaEnablerFill est appelée à 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) |