62238097c9
This is a safe cleanup change since top-level const applied to parameters in function declarations (that are not also definitions) are ignored by the compiler. Hence, such changes do not change the type of the declared functions and are simply no-ops. Bug: webrtc:13610 Change-Id: Ibafb92c45119a6d8bdb6f9109aa8dad6385163a9 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/249086 Reviewed-by: Niels Moller <nisse@webrtc.org> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Ali Tofigh <alito@webrtc.org> Cr-Commit-Position: refs/heads/main@{#35802}
73 lines
3.0 KiB
C++
73 lines
3.0 KiB
C++
/*
|
|
* Copyright (c) 2014 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef MODULES_DESKTOP_CAPTURE_WIN_SCREEN_CAPTURE_UTILS_H_
|
|
#define MODULES_DESKTOP_CAPTURE_WIN_SCREEN_CAPTURE_UTILS_H_
|
|
|
|
#if defined(WEBRTC_WIN)
|
|
// Forward declare HMONITOR in a windows.h compatible way so that we can avoid
|
|
// including windows.h.
|
|
#define WEBRTC_DECLARE_HANDLE(name) \
|
|
struct name##__; \
|
|
typedef struct name##__* name
|
|
WEBRTC_DECLARE_HANDLE(HMONITOR);
|
|
#undef WEBRTC_DECLARE_HANDLE
|
|
#endif
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "modules/desktop_capture/desktop_capturer.h"
|
|
#include "rtc_base/system/rtc_export.h"
|
|
|
|
namespace webrtc {
|
|
|
|
// Output the list of active screens into `screens`. Returns true if succeeded,
|
|
// or false if it fails to enumerate the display devices. If the `device_names`
|
|
// is provided, it will be filled with the DISPLAY_DEVICE.DeviceName in UTF-8
|
|
// encoding. If this function returns true, consumers can always assume that
|
|
// `screens`[i] and `device_names`[i] indicate the same monitor on the system.
|
|
bool GetScreenList(DesktopCapturer::SourceList* screens,
|
|
std::vector<std::string>* device_names = nullptr);
|
|
|
|
// Converts a device index (which are returned by `GetScreenList`) into an
|
|
// HMONITOR.
|
|
bool GetHmonitorFromDeviceIndex(DesktopCapturer::SourceId device_index,
|
|
HMONITOR* hmonitor);
|
|
|
|
// Returns true if `monitor` represents a valid display
|
|
// monitor. Consumers should recheck the validity of HMONITORs before use if a
|
|
// WM_DISPLAYCHANGE message has been received.
|
|
bool IsMonitorValid(HMONITOR monitor);
|
|
|
|
// Returns the rect of the monitor identified by `monitor`, relative to the
|
|
// primary display's top-left. On failure, returns an empty rect.
|
|
DesktopRect GetMonitorRect(HMONITOR monitor);
|
|
|
|
// Returns true if `screen` is a valid screen. The screen device key is
|
|
// returned through `device_key` if the screen is valid. The device key can be
|
|
// used in GetScreenRect to verify the screen matches the previously obtained
|
|
// id.
|
|
bool IsScreenValid(DesktopCapturer::SourceId screen, std::wstring* device_key);
|
|
|
|
// Get the rect of the entire system in system coordinate system. I.e. the
|
|
// primary monitor always starts from (0, 0).
|
|
DesktopRect GetFullscreenRect();
|
|
|
|
// Get the rect of the screen identified by `screen`, relative to the primary
|
|
// display's top-left. If the screen device key does not match `device_key`, or
|
|
// the screen does not exist, or any error happens, an empty rect is returned.
|
|
RTC_EXPORT DesktopRect GetScreenRect(DesktopCapturer::SourceId screen,
|
|
const std::wstring& device_key);
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // MODULES_DESKTOP_CAPTURE_WIN_SCREEN_CAPTURE_UTILS_H_
|