PVIDEO_HW_LEGACYRESOURCES コールバック関数 (video.h)
HwVidLegacyResources は、デバイスの PCI 構成領域にリストされていないが、デバイスによってデコードされたリソースの一覧を返します。
構文
PVIDEO_HW_LEGACYRESOURCES PvideoHwLegacyresources;
void PvideoHwLegacyresources(
[in] IN ULONG VendorId,
[in] IN ULONG DeviceId,
[in, out] IN OUT PVIDEO_ACCESS_RANGE *LegacyResourceList,
[in, out] IN OUT PULONG LegacyResourceCount
)
{...}
パラメーター
[in] VendorId
デバイスのベンダーを識別するコードを指定します。 これは、デバイスの PCI 構成空間で指定されたベンダー ID です。 詳細については、「 PCI デバイスの識別子」を参照してください。
[in] DeviceId
特定のデバイスを識別するコードを指定します。 これは、デバイスの PCI 構成領域で指定されたデバイス ID です。
[in, out] LegacyResourceList
VIDEO_ACCESS_RANGE構造体の配列へのポインター。 各構造体は、PCI 構成領域に記載されていないグラフィックス アダプターのデバイス I/O ポートまたはメモリ範囲を記述します。
[in, out] LegacyResourceCount
LegacyResourceList がポイントする配列内の要素の数を指定します。
戻り値
なし
解説
レガシ リソースは、デバイスの PCI 構成領域には表示されませんが、デバイスによってデコードされるリソースです。 デバイスのレガシ リソースリストがコンパイル時に不明な場合、ミニポート ドライバーは HwVidLegacyResources 関数を実装し、この関数を指す VIDEO_HW_INITIALIZATION_DATA の HwGetLegacyResources メンバーを初期化する必要があります。 たとえば、レガシ リソースの異なるセットを持つ 2 つのデバイスをサポートするミニポート ドライバーは、実行時に特定のデバイスのレガシ リソースを報告する HwVidLegacyResources を実装します。
HwVidLegacyResources によって返されるリソースは、PnP がデバイス用に予約するリソースの一覧に追加されます。
HwVidLegacyResources を ページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | video.h (Video.h を含む) |