Partager via


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)

Voir aussi

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter