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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| Regras de conformidade de DDI | IrqlDispatch(wdm) |