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

こちらもご覧ください

VideoPortAllocateCommonBuffer