VideoPortAllocateContiguousMemory 関数 (video.h)
VideoPortAllocateContiguousMemory 関数は、Windows 2000 以降では廃止されています。 ビデオ ミニポート ドライバーでは、その場所で VideoPortAllocateCommonBuffer を使用する必要があります。
VideoPortAllocateContiguousMemory は、非ページ プールから、物理的に連続したキャッシュアラインメモリの範囲を割り当てます。
構文
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG NumberOfBytes,
[in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);
パラメーター
[in] HwDeviceExtension
ミニポート ドライバーのデバイス拡張機能へのポインター。
[in] NumberOfBytes
割り当てる連続したメモリのブロックのサイズをバイト単位で指定します。
[in] HighestAcceptableAddress
ミニポート ドライバーが使用できる最も有効な物理アドレスを指定します。 たとえば、デバイスが下位 16 MB の物理メモリのみを参照できる場合、この値は 0x00000000FFFFFF に設定されます。
戻り値
VideoPortAllocateContiguousMemory は、呼び出しが成功した場合に、割り当てられたメモリのベース仮想アドレスを返します。 要求を満たすことができない場合は、 NULL が返されます。
注釈
VideoPortAllocateContiguousMemory を呼び出して、長期の内部バッファーに対して連続する物理メモリ ブロックを割り当てることができます。
連続したメモリを使用する必要があるミニポート ドライバーは、ドライバーの初期化中に必要なもののみを割り当てる必要があります。これは、非ページ プールがシステムの実行時に断片化する可能性があるためです。 ミニポート ドライバーがアンロードされた場合は、メモリの割り当てを解除する必要があります。 連続した割り当ては、キャッシュと一貫性の問題を防ぐために、プロセッサのデータ キャッシュ行サイズの整数倍に配置されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |
| Library | Videoprt.lib |
| [DLL] | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |