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 オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | videoagp.h (Video.h を含む) |
| IRQL | PASSIVE_LEVEL |