PAGP_RESERVE_PHYSICAL 콜백 함수(videoagp.h)

AgpReservePhysical 함수는 AGP 컨트롤러가 응답할 수 있는 시스템 버스에 다양한 물리적 주소를 예약합니다.

통사론

PAGP_RESERVE_PHYSICAL PagpReservePhysical;

PHYSICAL_ADDRESS PagpReservePhysical(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN ULONG Pages,
  [in]  IN VIDEO_PORT_CACHE_TYPE Caching,
  [out] OUT PVOID *PhysicalReserveContext
)
{...}

매개 변수

[in] HwDeviceExtension

미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

[in] Pages

비디오 포트 드라이버에서 예약해야 하는 페이지 수를 지정합니다.

[in] Caching

시스템에서 사용해야 하는 캐싱 유형을 지정하는 VIDEO_PORT_CACHE_TYPE 열거형입니다.

[out] PhysicalReserveContext

비디오 포트 드라이버가 예약된 실제 주소 공간을 식별하는 컨텍스트 핸들을 작성하는 위치를 지정합니다.

반환 값

AgpReservePhysical 성공하면 예약된 실제 주소 범위의 기본 주소를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

발언

Windows 2000에서 실행되는 비디오 미니포트 드라이버는 항상 크기가 64KB의 배수인 범위를 예약해야 합니다. 64KB의 배수가 아닌 범위를 예약하면 agpReserveVirtual 또는 AgpCommitVirtual 잘못된 가상 주소를 반환할 수 있습니다.

Windows XP 이상에서 AgpReservePhysical 요청된 범위를 64킬로바이트 배수로 자동으로 확장합니다.

성공적으로 반환되면 AGP 컨트롤러는 버스의 예약된 실제 주소 범위에 응답할 수 있습니다. 그러나 비디오 미니포트 드라이버는 먼저 AgpCommitPhysical 호출하여 액세스된 결과를 정의하기 위해 액세스하기 전에 이 메모리를 커밋해야 합니다.

미니포트 드라이버는 AgpReservePhysical 여러 번 호출하여 하나의 큰 범위가 아닌 많은 작은 주소 범위를 예약할 수 있습니다.

미니포트 드라이버는 더 이상 필요하지 않은 경우 AgpReleasePhysical 호출하여 실제 주소 범위를 해제해야 합니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000
대상 플랫폼	바탕 화면
헤더	videoagp.h(Video.h 포함)
IRQL	PASSIVE_LEVEL

참고 항목

agpCommitPhysical

AgpReleasePhysical

agpReserveVirtual