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 |