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

시스템에서 사용해야 하는 캐싱 유형을 지정합니다. 이 매개 변수는 다음 값 중 하나로 설정할 수 있습니다.

값	의미
VpNonCached	시스템에서 주소 범위를 캐시해서는 안 됩니다.
VpWriteCombined	시스템은 WC(쓰기 결합) 캐싱을 사용해야 합니다. WC 캐싱에 대한 자세한 내용은 비디오 미니포트 드라이버의 쓰기 결합 메모리 웹 사이트 문서를 참조하세요.
VpCached	시스템은 일반 캐싱을 사용해야 합니다.

[out] PhysicalReserveContext

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

반환 값

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

설명

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

Microsoft Windows XP 이상에서 AgpReservePhysical 은 요청된 범위를 64KB의 배수로 자동으로 확장합니다.

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

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

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	videoagp.h(Video.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

AgpCommitPhysical

AgpReleasePhysical

AgpReserveVirtual