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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 2000. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | IrqlDispatch(wdm) |