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 |