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 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.

Comentarios

GetDmaAlignment no es una rutina del sistema a la que se puede llamar directamente por su nombre. Esta rutina solo es invocable por puntero de la dirección devuelta en una estructura de DMA_OPERATIONS . Los controladores obtienen la dirección de esta rutina mediante una llamada 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 se debe usar 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, consulte Inicialización de un objeto device.

Requisitos

Consulte también

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter