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

추가 정보

AgpCommitVirtual

AgpReservePhysical

AgpReserveVirtual