VC_ReadProfile

DWORD
VC_ReadProfile(
    PVC_PROFILE_INFO pProfile,
    PWCHAR ValueName,
    DWORD dwDefault
    );

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

Parameters

pProfile

Address of the VC_PROFILE_INFO structure returned by VC_OpenProfileAccess.

ValueName

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. If the ValueName string does not exist in the registry, cannot be accessed, or is not a REG_DWORD type, 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 VCKernel.lib for kernel-mode video capture drivers. To see that function’s description, click here.

See Also

VC_ReadProfileString, VC_ReadProfileUser, VC_WriteProfile, VC_WriteProfileUser