PGET_DMA_ALIGNMENT funzione di callback (wdm.h)
La routine GetDmaAlignment restituisce i requisiti di allineamento del sistema DMA.
Sintassi
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parametri
[in] DmaAdapter
Puntatore alla struttura DMA_ADAPTER restituita da IoGetDmaAdapter che rappresenta l'adattatore bus-master o il controller DMA.
Valore restituito
GetDmaAlignment restituisce i requisiti di allineamento, in byte, del sistema DMA. L'indirizzo iniziale e la lunghezza dei buffer DMA devono essere un multiplo di questo valore.
Commenti
GetDmaAlignment non è una routine di sistema che può essere chiamata direttamente per nome. Questa routine è chiamabile solo dal puntatore dall'indirizzo restituito in una struttura di DMA_OPERATIONS . I driver ottengono l'indirizzo di questa routine chiamando IoGetDmaAdapter.
Un driver può chiamare questa routine per determinare i requisiti di allineamento per i buffer DMA allocati. Il valore restituito deve essere usato per impostare il campo AlignmentRequirement nell'oggetto dispositivo. Un driver potrebbe dover aumentare questo valore a causa di restrizioni aggiuntive dei dispositivi hardware. Per altre informazioni, vedere Inizializzazione di un oggetto Device.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | IrqlDispatch(wdm) |