WDF_ALIGN_SIZE_DOWN 함수(wdfcore.h)

[KMDF 및 UMDF에 적용]

WDF_ALIGN_SIZE_DOWN 함수는 지정된 맞춤 오프셋에 맞춰진 다음으로 낮은 버퍼 크기를 반환합니다.

구문

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

매개 변수

[in] Length

메모리 버퍼의 길이(바이트)입니다.

[in] AlignTo

맞춤 오프셋(바이트)입니다. 이 값은 2, 4, 8, 16 등과 같은 2의 힘이어야 합니다.

반환 값

WDF_ALIGN_SIZE_DOWN 정렬된 버퍼 크기를 바이트 단위로 반환합니다.

설명

드라이버는 WDF_ALIGN_SIZE_UP 또는 WDF_ALIGN_SIZE_DOWN 사용하여 지정된 맞춤 오프셋에 맞춰진 버퍼 크기를 계산할 수 있습니다. 이 계산은 각 버퍼가 주소 맞춤 경계에서 시작해야 하는 경우 드라이버가 여러 연속 버퍼를 할당해야 하는 경우에 유용합니다.

예제

다음 코드 예제에서는 버퍼 크기를 받고 DWORD 주소 경계에 맞는 크기(현재 크기 또는 다음 아래 크기)를 반환합니다.

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

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfcore.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	모든 IRQL.

추가 정보

WDF_ALIGN_SIZE_UP