VC_ReadProfile

DWORD
VC_ReadProfile(
    PDEVICE_INFO  pDevInfo,
    PWCHAR  szValueName,
    DWORD  dwDefault
    );

The VC_ReadProfile function reads the DWORD value associated with the specified value name, under the driver’s \Parameters registry key.

Parameters

pDevInfo

Pointer to the DEVICE_INFO structure returned by VC_Init.

szValueName

Pointer to a UNICODE string identifying the name of a registry value.

dwDefault

Specifies a default value that is returned if an error occurs locating or reading the requested value.

Return Value

Returns the value assigned to the ValueName string, if the operation succeeds. Otherwise the function returns the value specified by dwDefault.

Comments

The value name and value are read from the registry path HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DriverName\Parameters, where DriverName is the driver name specified as input to VC_OpenProfileAccess.

To store values under a driver’s \Parameters registry key, call VC_WriteProfile.

Note:  A function named VC_ReadProfile is also provided by VCUser.lib for user-mode video capture drivers. To see that function’s description, click here.