Monitor GetVCPFeatureAndVCPFeatureReply Function 

  • Article
 
Monitor Configuration API
Previous Next

GetVCPFeatureAndVCPFeatureReply Function

Retrieves the current value, maximum value, and code type of a Virtual Control Panel (VCP) code for a monitor.

Syntax

  BOOL GetVCPFeatureAndVCPFeatureReply(
  HANDLE
    hMonitor,

    BYTE
    bVCPCode,

    LPMC_VCP_CODE_TYPE
    pvct,

    LPDWORD
    pdwCurrentValue,

    LPDWORD
    pdwMaximumValue

  );

Parameters

hMonitor

[in]  Handle to a physical monitor. To get the monitor handle, call GetPhysicalMonitorsFromHMONITOR or GetPhysicalMonitorsFromIDirect3DDevice9.

bVCPCode

[in]  VCP code to query. The VCP codes are Include the VESA Monitor Control Command Set (MCCS) standard, versions 1.0 and 2.0. This parameter must specify a continuous or non-continuous VCP, or a vendor-specific code. It should not be a table control code.

pvct

[out]  Receives the VCP code type, as a member of the MC_VCP_CODE_TYPE enumeration. This parameter can be NULL.

pdwCurrentValue

[out]  Receives the current value of the VCP code. This parameter can be NULL.

pdwMaximumValue

[out]  If bVCPCode specifies a continuous VCP code, this parameter receives the maximum value of the VCP code. If bVCPCode specifies a non-continuous VCP code, the value received in this parameter is undefined. This parameter can be NULL.

Return Value

If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call GetLastError.

Remarks

This function corresponds to the "Get VCP Feature & VCP Feature Reply" command from the Display Data Channel Command Interface (DDC/CI) standard. Vendor-specific VCP codes can be used with this function.

This function takes about 40 milliseconds to return.

The following MCCS 1.0 codes are not supported: 0x5E, 0x60, 0xB0, 0xCA, 0xCC, 0xCE, 0xD6, and 0xDE. The following MCCS 2.0 codes are not supported: 0x60, 0xB0, 0xB7, 0xB8, 0xB9, 0xBA, 0xBB, 0xBC, 0xBD, 0xBE, 0xCA, 0xCC, 0xD6, and 0xDE. If the VCP code is not supported, the function fails and sets the last-error code to ERROR_UNSUPPORTED_VCP_CODE.

Requirements

Client: Requires Windows Vista.

Header: Include LowLevelMonitorConfigurationAPI.h.

Library: Use dxva2.lib.

See Also

Previous Next