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 で実行されるビデオ ミニポート ドライバーは、サイズが 64 KB の倍数である物理範囲を常に予約してコミットする必要があります。 64 KB の倍数ではない物理範囲を予約またはコミットすると、AgpReserveVirtual したり、AgpCommitVirtual を して無効な仮想アドレスが返されたりする可能性があります。

Windows XP 以降では、AgpCommitPhysical によってコミットされた範囲が自動的に拡張され、64 KB の倍数になります。

ビデオ ミニポート ドライバーが AgpCommitPhysical を呼び出すと、物理メモリのロックされたページ PhysicalReserveContext によって識別される物理アドレス範囲の一部がマップされます。 マップされた部分は、PhysicalReserveContextで識別される範囲に ページのオフセット 開始します。 ビデオ ミニポート ドライバーは、連続しているかのようにコミットされた物理メモリにアクセスできます。

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の	デスクトップ
ヘッダー	videoagp.h (Video.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

AgpCommitVirtual

AgpReservePhysical

AgpReserveVirtual の