PGET_DMA_ALIGNMENT fonction de rappel (wdm.h)

Article
02/29/2024

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)

Voir aussi