función WDF_ALIGN_SIZE_DOWN (wdfcore.h)

[Se aplica a KMDF y UMDF]

La función WDF_ALIGN_SIZE_DOWN devuelve el siguiente tamaño de búfer inferior que se alinea con un desplazamiento de alineación especificado.

Sintaxis

size_t WDF_ALIGN_SIZE_DOWN(
  [in] size_t Length,
  [in] size_t AlignTo
);

Parámetros

[in] Length

Longitud, en bytes, de un búfer de memoria.

[in] AlignTo

Desplazamiento de alineación, en bytes. Este valor debe ser una potencia de 2, como 2, 4, 8, 16, etc.

Valor devuelto

WDF_ALIGN_SIZE_DOWN devuelve el tamaño del búfer alineado, en bytes.

Comentarios

Los controladores pueden usar WDF_ALIGN_SIZE_UP o WDF_ALIGN_SIZE_DOWN para calcular un tamaño de búfer alineado con un desplazamiento de alineación especificado. Este cálculo es útil si el controlador debe asignar varios búferes contiguos, si cada búfer debe comenzar en un límite de alineación de direcciones.

Ejemplos

En el ejemplo de código siguiente se recibe un tamaño de búfer y se devuelve el tamaño (el tamaño actual o el siguiente tamaño inferior) que se alinea con un límite de dirección DWORD.

bufferSizeAligned = WDF_ALIGN_SIZE_DOWN(bufferSize,
                                        sizeof(DWORD));

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Versión mínima de UMDF	2.0
Encabezado	wdfcore.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	Cualquier IRQL.

Consulte también

WDF_ALIGN_SIZE_UP