VideoPortGetRegistryParameters

VP_STATUS VideoPortGetRegistryParameters(

PVOID HwDeviceExtension,
PWSTR ParameterName,
UCHAR IsParameterFileName,
PMINIPORT_GET_REGISTRY_ROUTINE CallbackRoutine,
PVOID Context
);

VideoPortGetRegistryParameters retrieves adapter-specific configuration information under the ..\CurrentControlSet\Services\DriverName\DeviceNumber key in the registry. VideoPortGetRegistryParameters automatically searches for the specified value entry name in the key for the miniport's current device.

Parameters

HwDeviceExtension

Points to the miniport driver's device extension.

ParameterName

Points to a zero-terminated Unicode string that names the value entry to be retrieved from the registry.

IsParameterFileName

If the value is TRUE, the data value normally returned is treated as a file name, and the buffered contents of that file are returned.

CallbackRoutine

Points to the miniport's HwVidQueryNamedValueCallback function.

Context

Points to a caller-determined context parameter to be passed to the CallbackRoutine. Usually, it points to the VIDEO_PORT_CONFIG_INFO buffer.

Return Value

VideoPortGetRegistryParameters returns NO_ERROR if it successfully collected the requested information and called the miniport's HwVidQueryNamedValueCallback function.

Comments

VideoPortGetRegistryParameters can be called only from a miniport's HwVidFindAdapter or HwVidInitialize function.

The registry key from which VideoPortGetRegistryParameters retrieves configuration information cannot contain any information about the corresponding display driver, because miniport HwVidFindAdapter functions execute before any user-mode display driver is loaded.

Miniports should not query configuration information stored in the DefaultSettings entries, which are not guaranteed to be defined in future versions of Windows NT.

See Also

HwVidFindAdapter, HwVidInitialize, HwVidQueryDeviceCallback, HwVidQueryNamedValueCallback, VIDEO_PORT_CONFIG_INFO, VideoPortGetDeviceData