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 転送の詳細については、ビデオ ミニポート ドライバー のBus-Master DMA を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | video.h (Video.h を含む) |
| ライブラリ | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |