WdfCommonBufferGetAlignedLogicalAddress 함수(wdfcommonbuffer.h)

[KMDF에만 적용]

WdfCommonBufferGetAlignedLogicalAddress 메서드는 지정된 공통 버퍼와 연결된 논리 주소를 반환합니다.

구문

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

매개 변수

[in] CommonBuffer

WdfCommonBufferCreate에 대한 이전 호출에서 드라이버가 가져온 공통 버퍼 개체에 대한 핸들입니다.

반환 값

WdfCommonBufferGetAlignedLogicalAddressCommonBuffer 매개 변수가 지정하는 공통 버퍼와 연결된 버퍼의 논리적 주소를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

논리 주소는 디바이스가 실제 메모리에 액세스하는 데 사용하는 매핑된 주소입니다.

드라이버가 WdfDeviceSetAlignmentRequirement 를 호출하여 버퍼 맞춤 요구 사항을 설정하는 경우 프레임워크는 해당 맞춤 요구 사항에 따라 공통 버퍼를 정렬합니다.

일반적인 버퍼에 대한 자세한 내용은 공통 버퍼 사용을 참조하세요.

예제

WdfCommonBufferGetAlignedLogicalAddress를 사용하는 코드 예제는 WdfCommonBufferCreate를 참조하세요.

요구 사항

요구 사항
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfcommonbuffer.h(WdfCommonBuffer.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement