VideoPortGetCommonBuffer 関数 (video.h)
VideoPortGetCommonBuffer 関数は、Windows XP 以降では廃止されており、既存のドライバーとの下位互換性のためにのみサポートされています。 その代わりに、ドライバー ライターは VideoPortAllocateCommonBuffer を使用する必要があります。
VideoPortGetCommonBuffer は、システム メモリを割り当ててマップし、共通バッファー DMA 操作のためにプロセッサとデバイスの両方から同時にアクセスできるようにします。
構文
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG DesiredLength,
[in] IN ULONG Alignment,
[out] OUT PPHYSICAL_ADDRESS LogicalAddress,
[out] OUT PULONG pActualLength,
[in] IN BOOLEAN CacheEnabled
);
パラメーター
[in] HwDeviceExtension
ミニポート ドライバーのデバイス拡張機能へのポインター。
[in] DesiredLength
要求されたメモリバイト数を指定します。
[in] Alignment
バッファーの要求された配置を指定します。 ビデオ ポート ドライバーは現在、このパラメーターを無視します。
[out] LogicalAddress
アダプターが割り当てられたバッファーにアクセスするために使用する論理アドレスを受け取る変数へのポインター。
[out] pActualLength
この要求に割り当てられたバッファーの実際のサイズ (バイト単位) を受け取る変数へのポインター。
[in] CacheEnabled
割り当てられたメモリをキャッシュできるかどうかを指定します。
戻り値
VideoPortGetCommonBuffer は 、成功した場合、割り当てられたバッファーのベース仮想アドレスを返します。それ以外の場合は、バッファーを割り当てることができない場合は NULL を 返します。
注釈
パケット ベースおよび共通バッファー DMA 転送の詳細については、「 ビデオ ミニポート ドライバーのバス マスター DMA」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |
| Library | Videoprt.lib |
| [DLL] | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |