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)

Vedi anche

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter