VideoPortAllocateCommonBuffer 関数 (video.h)

VideoPortAllocateCommonBuffer 関数は、システム メモリを割り当ててマップし、一般的なバッファー DMA 操作のためにプロセッサとデバイスの両方から同時にアクセスできるようにします。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN PVP_DMA_ADAPTER    VpDmaAdapter,
  [in]  IN ULONG              DesiredLength,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [in]  IN BOOLEAN            CacheEnabled,
  [out] OUT PVOID             Reserved
);

パラメーター

[in] HwDeviceExtension

ミニポート ドライバーのデバイス拡張機能へのポインター。

[in] VpDmaAdapter

バス マスター アダプターを表す VP_DMA_ADAPTER 構造体へのポインター。 この構造体は、 VideoPortGetDmaAdapter の以前の呼び出しによって返されました。

[in] DesiredLength

要求されたメモリバイト数を指定します。

[out] LogicalAddress

アダプターが割り当てられたバッファーにアクセスするために使用する論理アドレスを受け取るメモリ位置へのポインター。

[in] CacheEnabled

割り当てられたメモリをキャッシュできるかどうかを指定します。 詳細については、AllocateCommonBuffer の CacheEnabled パラメーターの説明を参照してください。

[out] Reserved

現在、ビデオ ポート ドライバーでは無視されます。 は NULL に設定する必要があります。

戻り値

VideoPortAllocateCommonBuffer は 、成功した場合、割り当てられたバッファーのベース仮想アドレスを返します。それ以外の場合は、バッファーを割り当てることができない場合は NULL を 返します。

注釈

バッファーが不要になった場合、ビデオ ミニポート ドライバーは VideoPortReleaseCommonBuffer を呼び出して解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム	デスクトップ
Header	video.h (Video.h を含む)
Library	Videoprt.lib
[DLL]	Videoprt.sys
IRQL	PASSIVE_LEVEL

こちらもご覧ください

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer