VideoPortGetAccessRanges 関数 (video.h)

  • [アーティクル]

廃止。 VideoPortGetAccessRanges 関数は、バス相対構成情報を取得し、可能であれば、呼び出し元のレジストリでこれらのハードウェア リソースを要求します。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetAccessRanges(
  PVOID                   HwDeviceExtension,
  ULONG                   NumRequestedResources,
  PIO_RESOURCE_DESCRIPTOR RequestedResources,
  ULONG                   NumAccessRanges,
  PVIDEO_ACCESS_RANGE     AccessRanges,
  PVOID                   VendorId,
  PVOID                   DeviceId,
  PULONG                  Slot
);

パラメーター

HwDeviceExtension

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

NumRequestedResources

RequestedResources 配列内の要素の数を指定します。

RequestedResources

[入力、省略可能]IO_RESOURCE_DESCRIPTOR型要素の配列。 各記述子は、ミニポート ドライバーが必要、優先、または別の配列要素で指定された代替として使用できる 1 つのハードウェア リソースを指定します。 この構造の詳細については、IoAssignResourcesの説明 参照してください。

NumAccessRanges

AccessRanges 配列内の要素の数を指定します。

AccessRanges

[out]VideoPortGetAccessRanges がアダプターのバス相対デバイス メモリ範囲で満たされた VIDEO_ACCESS_RANGE 要素の配列を返すミニポート ドライバー内のスタック上の領域または静的構造体へのポインター。

VendorId

NULL に設定する必要があります。

DeviceId

NULL に設定する必要があります。

Slot

ビデオ ポート ドライバーがデバイスのスロット番号を格納するメモリの場所へのポインター。または NULL です。

プラグ アンド プレイ デバイスの場合、これが有効なポインターの場合、ビデオ ポート ドライバーは、ポインターで指定されたメモリ位置にスロット番号を格納します。 NULL 値が呼び出しで渡された場合、ビデオ ポート ドライバーは場所に値を格納しません。

戻り値

VideoPortGetAccessRanges は、AccessRanges 情報が正常に入力された場合、または RequestedResourcesで構成情報 返された場合にNO_ERRORを返します。

備考

すべてのビデオ ミニポート ドライバーは、VideoPortGetAccessRangesによって返されるアクセス範囲を使用する必要があります。または、ドライバー (およびシステム) の初期化プロセス中にビデオ アダプターにアクセスする前に、VideoPortVerifyAccessRanges を呼び出す必要があります。

VideoPortGetAccessRanges は、ミニポート ドライバーの HwVidFindAdapter 関数からのみ呼び出すことができます。

ほとんどのミニポート ドライバーの場合、VideoPortGetAccessRanges は、バス相対アクセス範囲と、特定のビデオ アダプターで使用される割り込みや DMA チャネル/ポートを取得、検証、および要求できますが、VideoPortVerifyAccessRanges はミニポート ドライバーが指定したリソースのみを検証および要求できます。 つまり、返されるすべての構成情報について、VideoPortGetAccessRanges 呼び出し元のレジストリ内の対応するハードウェア リソースを要求します。 ミニポート ドライバーが返された値のいずれかを変更しようとする場合を除き、ミニポート ドライバーは、返されたバスの相対構成情報 VideoPortVerifyAccessRanges を呼び出す必要はありません。

VideoPortGetAccessRanges または特定のアダプターの VideoPortVerifyAccessRanges への呼び出しが成功するたびに、レジストリ内のハードウェア リソースに対するミニポート ドライバーの前述の要求が上書きされます。

VideoPortGetAccessRanges正常に呼び出された後、ミニポート ドライバーは、アダプターと通信するために適切な VideoPortRead/Write****Xxx 関数を呼び出 前に、返されたバス相対範囲を VideoPortGetDeviceBase論理範囲にマップする必要があります。

通常、PCI デバイスのミニポート ドライバーは、VideoPortGetBusDataの呼び出しによって返される非デバイス固有のPCI_COMMON_CONFIG情報を操作するのではなく、VideoPortGetAccessRanges 関数呼び出し HwVidFindAdapter を持つ必要があります。 このミニポート ドライバーは、通常、nullRequestedResources ポインターを使用して VideoPortGetAccessRanges 呼び出すことができます。 その後、ビデオ ポート ドライバーは、PCI バスの構成領域を使用して、ビデオ アダプターのリソースを決定します。 ミニポート ドライバーは、VideoPortGetAccessRangesを呼び出すことができます。その元の呼び出しがアダプターの有効な構成データを返さなければ、ドライバー指定の RequestedResources 仕様を使用します。

他の種類の I/O バス上のアダプターのミニポート ドライバーは、VideoPortGetAccessRanges呼び出すこともできることに注意してください。 これらのドライバーは、RequestedResources I/O リソース記述子のドライバー指定配列へのポインターを使用して、VideoPortGetAccessRanges を呼び出す必要があります。

HwVidFindAdapter 関数が、バス相対アクセス範囲と、場合によってはアダプターの他のハードウェア リソースを要求する場合、 ただし、アダプターをサポートしていないと判断した場合、ミニポート ドライバーは、VideoPortGetAccessRanges を呼び出すか、NumAccessRanges パラメーターを 0 に設定して VideoPortVerifyAccessRanges を することによって、レジストリ内のハードウェア リソースに対する要求を放棄する必要があります。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000
ターゲット プラットフォーム の デスクトップ
ヘッダー video.h (Video.h を含む)
ライブラリ Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

関連項目

HwVidFindAdapter の

IoAssignResources の

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VIDEO_PORT_CONFIG_INFO

VideoPortGetBusData

VideoPortGetDeviceBase の

VideoPortSetBusData

VideoPortVerifyAccessRanges