PGET_DMA_ALIGNMENT fonction de rappel (wdm.h)
La routine GetDmaAlignment retourne les exigences d’alignement du système DMA.
Syntaxe
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Paramètres
[in] DmaAdapter
Pointeur vers la structure DMA_ADAPTER retournée par IoGetDmaAdapter qui représente l’adaptateur master bus ou le contrôleur DMA.
Valeur retournée
GetDmaAlignment retourne les exigences d’alignement, en octets, du système DMA. L’adresse de départ et la longueur des mémoires tampons DMA doivent être un multiple de cette valeur.
Remarques
GetDmaAlignment n’est pas une routine système qui peut être appelée directement par nom. Cette routine peut être appelée uniquement par le pointeur de l’adresse retournée dans une structure DMA_OPERATIONS . Les pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter.
Un pilote peut appeler cette routine pour déterminer les exigences d’alignement pour les mémoires tampons DMA qu’il alloue. La valeur retournée doit être utilisée pour définir le champ AlignmentRequirement dans l’objet d’appareil. Un pilote peut avoir besoin d’augmenter cette valeur en raison de restrictions de périphériques matériels supplémentaires. Pour plus d’informations, consultez Initialisation d’un objet Device.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | IrqlDispatch(wdm) |