VideoPortLockPages 関数 (video.h)

  • [アーティクル]

VideoPortLockPages 関数は、Windows 2000 以降では廃止されています。 この関数の代わりに VideoPortLockBuffer を使用します。

VideoPortLockPages は 、指定された仮想メモリをロックし、場合によっては DMA 転送の一部またはすべてを実行します。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortLockPages(
  [in]      IN PVOID                     HwDeviceExtension,
  [in, out] IN OUT PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PEVENT                    pUEvent,
  [in]      IN PEVENT                    pDisplayEvent,
  [in]      IN DMA_FLAGS                 DmaFlags
);

パラメーター

[in] HwDeviceExtension

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

[in, out] pVrp

VIDEO_REQUEST_PACKET構造体へのポインター。 ミニポート ドライバーは、 InputBuffer と InputBufferLength を設定して、転送用にロックするメモリの仮想アドレスとサイズ (バイト単位) をそれぞれ設定する必要があります。 このメモリは、ディスプレイ ドライバーによって割り当てられ、IOCTL を介してミニポート ドライバーに渡されました。 ビデオ ポートは、 へのポインターと 、OutputBuffer と OutputBufferLength の散布/収集リストのサイズ (バイト単位) をそれぞれ返します。

[in] pUEvent

ミニポート ドライバーによって設定されるマップされたユーザー イベントへのポインター、または NULL。 ユーザー イベントは、ディスプレイ ドライバーによってマップされ、IOCTL を介してミニポート ドライバーに渡されました。

[in] pDisplayEvent

ミニポート ドライバーによって設定されるイベントへのポインター、または NULL。 このイベントは によって作成され、IOCTL を介してディスプレイ ドライバーから受信されました。

[in] DmaFlags

実行する操作を指定します。 このパラメーターは、次のいずれかの値である必要があります。

値 意味
VideoPortDmaInitOnly VideoPortLockPages は、要求されたメモリをロックします。
VideoPortKeepPagesLocked VideoPortLockPages は何も実行しません。
VideoPortUnlockAfterDma VideoPortLockPages は何も実行しません。

戻り値

VideoPortLockPages は、 要求されたアクションが正常に完了すると TRUE を 返します。 DmaFlags パラメーターが VideoPortDmaInitOnly と等しくない場合は FALSE を返します。

注釈

パケット ベースおよび共通バッファー DMA 転送の詳細については、「 ビデオ ミニポート ドライバーのバス マスター DMA 」を参照してください。

VideoPortLockPages を ISR または DPC から呼び出すことはできません。

要件

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

こちらもご覧ください

VideoPortLockBuffer