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.

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