PGET_DMA_ALIGNMENT función de devolución de llamada (wdm.h)

La rutina GetDmaAlignment devuelve los requisitos de alineación del sistema DMA.

Sintaxis

PGET_DMA_ALIGNMENT PgetDmaAlignment;

ULONG PgetDmaAlignment(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parámetros

[in] DmaAdapter

Puntero a la estructura de DMA_ADAPTER devuelta por ioGetDmaAdapter que representa el adaptador de bus-master o el controlador DMA.

Valor devuelto

GetDmaAlignment devuelve los requisitos de alineación, en bytes, del sistema DMA. La dirección inicial y la longitud de los búferes DMA deben ser un múltiplo de este valor.

Observaciones

GetDmaAlignment no es una rutina del sistema a la que se puede llamar directamente por nombre. Esta rutina solo se puede llamar por puntero de la dirección devuelta en una estructura de DMA_OPERATIONS. Los controladores obtienen la dirección de esta rutina llamando a IoGetDmaAdapter.

Un controlador puede llamar a esta rutina para determinar los requisitos de alineación de los búferes DMA que asigna. El valor devuelto debe usarse para establecer el campo AlignmentRequirement en el objeto de dispositivo. Es posible que un controlador tenga que aumentar este valor debido a restricciones adicionales de dispositivos de hardware. Para obtener más información, vea Inicializar un objeto de dispositivo.

Requisitos

Consulte también

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter