VideoPortGetRegistryParameters
TOC
Collapse the table of content
Expand the table of content

VideoPortGetRegistryParameters function

The VideoPortGetRegistryParameters function retrieves device-specific configuration information under the adapter key in the registry at startup.

Syntax


VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  _In_ PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE CallbackRoutine,
       PVOID                          Context
);

Parameters

HwDeviceExtension

Pointer to the miniport driver's device extension.

ParameterName [in]

Pointer to a NULL-terminated Unicode string that names the value entry to be retrieved from the registry. See the Remarks section for more information.

IsParameterFileName

If the value is TRUE, the data value normally returned is treated as a file name. In that case, the buffered contents of that file are returned, rather than the parameter itself.

CallbackRoutine

Pointer to the miniport driver's HwVidQueryNamedValueCallback function.

Context

Pointer to a caller-determined context parameter to be passed to the CallbackRoutine, typically the VIDEO_PORT_CONFIG_INFO buffer.

Return value

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

Remarks

VideoPortGetRegistryParameters cannot be called from a miniport driver's HwVidInterrupt or HwVidTimer functions, or from VideoPortQueueDpc, or from a callback to VideoPortSynchronizeExecution.

For Windows XP and later operating system versions, the ParameterName parameter can contain a path that exactly references a value name one or more levels below the adapter key. For example, the string "SubKey1\Value1" can be used to obtain the value entry for the Value1 value number under the SubKey1 subkey.

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

Miniport drivers should not query configuration information stored in the DefaultSettings entries, which may not be supported in later versions of the operating system.

Requirements

Target platform

Desktop

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Video.h (include Video.h)

Library

Videoprt.lib

DLL

Videoprt.sys

IRQL

PASSIVE_LEVEL

See also

HwVidFindAdapter
HwVidInitialize
HwVidQueryDeviceCallback
HwVidQueryNamedValueCallback
VIDEO_PORT_CONFIG_INFO
VideoPortGetDeviceData
VideoPortFlushRegistry
VideoPortSetRegistryParameters

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft