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