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 DMA_ADAPTER retornada por IoGetDmaAdapter que representa o adaptador de master de barramento ou o controlador de DMA.

Retornar valor

GetDmaAlignment retorna os requisitos de alinhamento, em bytes, do sistema de DMA. O endereço inicial e o comprimento dos buffers de DMA devem ser um múltiplo desse valor.

Comentários

GetDmaAlignment não é uma rotina do sistema que pode ser chamada diretamente pelo nome. Essa rotina pode ser chamada somente 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. 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 device.

Requisitos

Confira também

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter