WDF_COMMON_BUFFER_CONFIG 구조체(wdfcommonbuffer.h)

아티클
02/26/2024

[KMDF에만 적용]

WDF_COMMON_BUFFER_CONFIG 구조에는 공통 버퍼에 대한 구성 정보가 포함되어 있습니다.

구문

typedef struct _WDF_COMMON_BUFFER_CONFIG {
  ULONG Size;
  ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;

멤버

Size

이 구조체의 크기(바이트)입니다.

AlignmentRequirement

공통 버퍼에 대한 맞춤 요구 사항입니다. 이 값은 맞춤 경계보다 작아야 합니다. 예를 들어 16비트 맞춤 경계에 15를, 32비트 맞춤 경계에 31을 지정할 수 있습니다. Wdm.h에 정의된 FILE_Xxxx_ALIGNMENT 상수 중 하나를 사용할 수도 있습니다.

설명

WDF_COMMON_BUFFER_CONFIG 구조체는 WdfCommonBufferCreateWithConfig 메서드에 대한 입력으로 사용됩니다.

드라이버가 컴퓨터의 페이지 크기(PAGE_SIZE)보다 큰 맞춤 요구 사항을 지정하는 경우 WdfCommonBufferGetAlignedLogicalAddress 메서드가 반환하는 논리적 주소는 항상 지정된 맞춤 요구 사항에 맞춰지지만 WdfCommonBufferGetAlignedVirtualAddress 메서드가 반환하는 가상 주소는 맞춤 요구 사항에 맞지 않을 수 있습니다.

드라이버가 컴퓨터의 페이지 크기보다 작은 맞춤 요구 사항을 지정하는 경우 모든 논리 및 가상 주소가 지정된 맞춤 요구 사항에 맞춰집니다.

맞춤 요구 사항을 지정하는 방법에 대한 자세한 내용은 DMA 트랜잭션 사용 및 공통 버퍼 사용을 참조하세요.