PAGP_RESERVE_VIRTUAL 콜백 함수(videoagp.h)
AgpReserveVirtual 함수는 AGP에 대한 다양한 가상 주소를 예약합니다.
통사론
PAGP_RESERVE_VIRTUAL PagpReserveVirtual;
PVOID PagpReserveVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN HANDLE ProcessHandle,
[in] IN PVOID PhysicalReserveContext,
[out] OUT PVOID *VirtualReserveContext
)
{...}
매개 변수
[in] HwDeviceExtension
미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.
[in] ProcessHandle
가상 주소 범위를 예약할 프로세스의 핸들입니다. ProcessHandle 0이면 가상 주소 범위가 시스템 공간에 할당됩니다.
[in] PhysicalReserveContext
가상 메모리 예약을 연결할 예약된 실제 주소 범위를 식별하는 컨텍스트 핸들입니다. 이 컨텍스트는 AgpReservePhysical.
[out] VirtualReserveContext
비디오 포트 드라이버가 예약된 가상 메모리를 식별하는 컨텍스트 핸들을 작성하는 위치입니다.
반환 값
AgpReserveVirtual 성공하면 예약된 가상 주소 범위의 기본 주소를 반환합니다. 그렇지 않으면 NULL 반환합니다.
발언
ProcessHandle 0이 아니면 AgpReserveVirtual 예약을 사용자 모드 프로세스의 주소 공간에 있는 다양한 가상 주소 범위를 커밋하지 않습니다. 이 경우 AgpCommitVirtual 호출하여 예약된(사용자 모드) 가상 주소를 실제 주소에 매핑해야 합니다.
processHandle 경우 AgpReserveVirtual 시스템 공간에서 가상 주소 범위를 할당하고 전체 가상 주소 범위를 실제 주소에 자동으로 매핑(커밋)합니다. AgpReserveVirtual 전체 가상 범위를 커밋하더라도 코드가 가상 범위에 액세스하기 전에 AgpCommitVirtual 호출해야 합니다.
AgpReserveVirtual 호출하여 시스템 공간의 가상 주소 범위를 할당하는 경우(즉, ProcessHandle 0으로 설정한 경우) PhysicalReserveContext 식별된 전체 물리적 주소 범위는 AgpCommitPhysical 이전 호출에 의해 물리적 메모리의 잠긴 페이지에 커밋되어야 합니다.
미니포트 드라이버는 AgpReleaseVirtual 여러 번 호출하여 하나의 큰 범위가 아닌 많은 작은 주소 범위를 예약할 수 있습니다.
미니포트 드라이버는 더 이상 필요하지 않은 경우 AgpReleaseVirtual 호출하여 예약된 가상 주소 범위를 해제해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | videoagp.h(Video.h 포함) |
| IRQL | PASSIVE_LEVEL |