PGET_DMA_ALIGNMENT função de retorno de chamada (wdm.h)
A rotina GetDmaAlignment retorna os requisitos de alinhamento do sistema DMA.
Sintaxe
PGET_DMA_ALIGNMENT PgetDmaAlignment;
ULONG PgetDmaAlignment(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Parâmetros
[in] DmaAdapter
Um ponteiro para a estrutura de DMA_ADAPTER retornada por IoGetDmaAdapter que representa o adaptador mestre do barramento ou o controlador DMA.
Valor de retorno
GetDmaAlignment retorna os requisitos de alinhamento, em bytes, do sistema DMA. O endereço inicial e o comprimento dos buffers de DMA devem ser múltiplos desse valor.
Observações
GetDmaAlignment não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina só pode ser chamada por ponteiro do endereço retornado em uma estrutura de DMA_OPERATIONS. Os drivers obtêm o endereço dessa rotina chamando IoGetDmaAdapter.
Um driver pode chamar essa rotina para determinar os requisitos de alinhamento para buffers de DMA alocados por ele. O valor retornado deve ser usado para definir o campo AlignmentRequirement no objeto do dispositivo. Um driver pode precisar aumentar esse valor devido a restrições adicionais de dispositivo de hardware. Para obter mais informações, consulte Inicializando um objeto de dispositivo.