PVIDEO_HW_LEGACYRESOURCES callback function (video.h)

Article
10/21/2021

HwVidLegacyResources returns a list of resources that are not listed in a device's PCI configuration space but that are decoded by the device.

Syntax

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
)
{...}

Parameters

[in] VendorId

Specifies a code that identifies the device's vendor. This is the vendor ID specified in the device's PCI configuration space. For more information, see Identifiers for PCI Devices.

[in] DeviceId

Specifies a code that identifies the particular device. This is the device ID specified in the device's PCI configuration space.

[in, out] LegacyResourceList

Pointer to an array of VIDEO_ACCESS_RANGE structures. Each structure describes a device I/O port or memory range for the graphics adapter that is not listed in PCI configuration space.

[in, out] LegacyResourceCount

Is the number of elements in the array to which LegacyResourceList points.

Return value

None

Remarks

Legacy resources are those resources that are not listed in the device's PCI configuration space but that are decoded by the device. If the legacy resource list for the device is not known at compile time, a miniport driver should implement a HwVidLegacyResources function and initialize the HwGetLegacyResources member of VIDEO_HW_INITIALIZATION_DATA to point to this function. For example, a miniport driver that supports two devices with different sets of legacy resources would implement HwVidLegacyResources to report the legacy resources for a particular device at run time.

The resources returned by HwVidLegacyResources are added to the list of resources that PnP reserves for the device.

HwVidLegacyResources should be made pageable.

Requirements

Requirement	Value
Target Platform	Desktop
Header	video.h (include Video.h)