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 オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | video.h (Video.h を含む) |
| ライブラリ | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |