DDCCIGetCapabilitiesString function

Article
12/11/2020

Important

This function is used by the monitor configuration API to access functionality in the display driver. Applications should not call this function.

Gets a string that describes the capabilities of a monitor.

Syntax

NTSTATUS WINAPI DDCCIGetCapabilitiesString(
  _In_  HANDLE hMonitor,
  _Out_ LPSTR  pszString,
  _In_  DWORD  dwLength
);

Parameters

hMonitor [in]: A handle to a physical monitor.
pszString [out]: A pointer to a buffer that receives the capabilities string. To get the length of the capabilities string, call DDCCIGetCapabilitiesStringLength.
dwLength [in]: The size of the pszString buffer, in characters, including the terminating null character.

Return value

If the method succeeds, it returns STATUS_SUCCESS. Otherwise, it returns an NTSTATUS error code.

Remarks

Applications should call CapabilitiesRequestAndCapabilitiesReply instead of calling this function.

This function has no associated import library. To call this function, you must use the LoadLibrary and GetProcAddress functions to dynamically link to Gdi32.dll.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
DLL	Gdi32.dll