IOCTL_HAL_QUERY_DISPLAYSETTINGS (Compact 2013)

10/16/2014

This I/O control message is used by graphics device interface (GDI) to query the kernel for information about a preferred resolution for the system to use. Send this message with OEMIoControl.

Syntax

BOOL OEMIoControl(
    DWORD dwIoControlCode,    // use IOCTL_HAL_QUERY_DISPLAYSETTINGS
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned   // number of bytes returned
);

Parameters

  • dwIoControlCode
    [in] Control code for the operation. Use IOCTL_HAL_QUERY_DISPLAYSETTINGS for this operation.
  • lpInBuffer
    [in] Set to NULL.
  • nInBufferSize
    [in] Set to zero.
  • lpOutBuffer
    [out] Array of three DWORDs. If the call succeeds, the first DWORD contains the preferred width, the second contains the preferred height, and the third contains the color depth in bits per pixel.
  • nOutBufferSize
    [in] Size of the three DWORDs.
  • lpBytesReturned
    [in] Actual number of bytes returned by lpOutBuffer.

Return Values

Returns TRUE if successful; otherwise, returns FALSE.

Remarks

To get extended error information, call GetLastError. GetLastError may return other standard error messages as appropriate.

Requirements

Header

pkfuncs.h

See Also

Reference

Device Information IOCTLs
OEMIoControl