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