VideoPortFreeDeviceBase 関数 (video.h)

  • [アーティクル]

VideoPortFreeDeviceBase 関数は、以前にシステム アドレス空間にマップされたバス相対デバイス I/O ポートまたはメモリ アドレスの範囲を解放します。 これは、 VideoPortGetDeviceBase を呼び出すことによって行います。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API VOID VideoPortFreeDeviceBase(
  PVOID HwDeviceExtension,
  PVOID MappedAddress
);

パラメーター

HwDeviceExtension

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

MappedAddress

解放するマップされた範囲のベース アドレスを指定します。 この値は、 VideoPortGetDeviceBase の前の呼び出しによって返される値と同じである必要があります。

戻り値

なし

解説

ミニポート ドライバーが既にサポートできないアダプターのアドレス範囲をマップしている場合は、ミニポート ドライバーの HwVidFindAdapter 関数から VideoPortFreeDeviceBase を呼び出す必要があります。

この場合、ミニポート ドライバーは、レジストリ内の対応するハードウェア リソースに対する要求も解放する必要があります。 特定のアダプターのリソースに対するすべての要求を解放するには、NumAccessRanges パラメーターを 0 に設定して VideoPortVerifyAccessRanges または VideoPortGetAccessRanges を呼び出します。 選択したアクセス範囲の要求を解放するには、次の操作を行います。

  1. 適切な要素の RangeLength を 0 に設定して、アダプターの要求されたバス相対範囲のアクセス範囲配列を変更します。 ミニポート ドライバーが要求を解放しないすべての要素では、現在の仕様をそのままにします。
  2. この変更された AccessRanges 配列を使用して VideoPortVerifyAccessRanges を呼び出します。

要件

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

こちらもご覧ください

HwVidFindAdapter

VideoPortGetAccessRanges

VideoPortGetDeviceBase

VideoPortVerifyAccessRanges