PAGP_FREE_VIRTUAL 콜백 함수(videoagp.h)

AgpFreeVirtual 함수는 AgpCommitVirtual에 대한 이전 호출로 커밋된 가상 메모리를 해제합니다.

구문

PAGP_FREE_VIRTUAL PagpFreeVirtual;

void PagpFreeVirtual(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID VirtualReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

매개 변수

[in] HwDeviceExtension

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

[in] VirtualReserveContext

예약된 가상 주소 범위를 식별합니다. 이 컨텍스트 핸들은 AgpReserveVirtual에서 가져옵니다.

[in] Pages

비디오 포트 드라이버가 매핑을 해제해야 하는 가상 메모리의 페이지 수를 지정합니다.

[in] Offset

가상 메모리의 매핑을 해제할 실제 기본 주소를 나타내는 VirtualReserveContext 로 식별되는 예약된 가상 주소 범위로 페이지 오프셋을 지정합니다.

반환 값

없음

설명

미니포트 드라이버가 AgpFreeVirtual을 호출하면 가상 주소의 페이지 페이지가 매핑되지 않습니다. 매핑되지 않은 범위는 VirtualReserveContext와 연결된 범위로 페이지 오프셋을 시작합니다. 미니포트 드라이버는 AgpCommitVirtual에 대한 이전 호출에서 커밋된 대로 정확한 오프셋 및 페이지 수를 해제하도록 지정해야 합니다.

AgpFreeVirtual에 대한 호출은 AgpCommitVirtual에 대한 이전 호출과 쌍을 이루어야 하며 AgpCommitVirtual에 대한 호출 앞에 AgpReserveVirtual을 성공적으로 호출해야 합니다. AgpReserveVirtual이 실패하면(NULL 반환), AgpCommitVirtual 또는 AgpFreeVirtual을 호출하면 안 됩니다.

요구 사항

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

추가 정보

AgpCommitVirtual