PAGP_COMMIT_PHYSICAL 콜백 함수(videoagp.h)
AgpCommitPhysical 함수는 시스템(물리적) 메모리를 지정된 AGP 디코딩 가능한 물리적 주소 범위에 매핑합니다.
구문
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
매개 변수
[in] HwDeviceExtension
미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.
[in] PhysicalReserveContext
예약된 실제 주소 범위를 식별합니다. 컨텍스트 핸들은 AgpReservePhysical에서 가져옵니다.
[in] Pages
커밋할 시스템 메모리의 페이지 수를 지정합니다.
[in] Offset
페이지를 커밋할 페이지 오프셋을 지정합니다. 오프셋은 PhysicalReserveContext와 연결된 예약된 물리적 주소 범위에 적용됩니다.
반환 값
매핑에 성공하면 AgpCommitPhysical 이 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다.
설명
비디오 미니포트 드라이버는 먼저 이 함수를 호출하기 전에 AgpReservePhysical 을 호출하여 물리적 주소를 예약해야 합니다.
AgpCommitPhysical을 호출하여 이미 커밋된 주소를 커밋하지 마세요. PhysicalReserveContext, Pages 및 Offset으로 지정된 페이지 범위에 이전에 커밋된 페이지가 포함된 경우 AgpCommitPhysical이 실패할 수 있습니다.
Microsoft Windows 2000에서 실행되는 비디오 미니포트 드라이버는 항상 크기가 64KB의 배수인 물리적 범위를 예약하고 커밋해야 합니다. 64KB의 배수가 아닌 물리적 범위를 예약하거나 커밋하면 AgpReserveVirtual 또는 AgpCommitVirtual 이 잘못된 가상 주소를 반환할 수 있습니다.
Windows XP 이상에서 AgpCommitPhysical 은 커밋된 범위를 자동으로 확장하여 64KB의 배수가 됩니다.
비디오 미니포트 드라이버가 AgpCommitPhysical을 호출하면 PhysicalReserveContext 로 식별된 물리적 주소 범위의 일부가 실제 메모리의 잠긴 페이지에 매핑됩니다. 매핑된 부분은 PhysicalReserveContext로 식별되는 범위로 페이지 오프셋을 시작합니다. 비디오 미니포트 드라이버는 연속된 것처럼 커밋된 실제 메모리에 액세스할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | videoagp.h(Video.h 포함) |
| IRQL | PASSIVE_LEVEL |