getWindowDisplayAffinity 函式 (winuser.h)

從指定視窗的任何進程擷取目前的顯示親和性設定。

語法

BOOL GetWindowDisplayAffinity(
  [in]  HWND  hWnd,
  [out] DWORD *pdwAffinity
);

參數

[in] hWnd

類型： HWND

視窗的句柄。

[out] pdwAffinity

類型： DWORD*

接收顯示親和性設定之變數的指標。 如需親和性設定及其意義的清單，請參閱 SetWindowDisplayAffinity 。

傳回值

類型： BOOL

只有當視窗分層且桌面 Windows 管理員正在撰寫桌面時，此函式才會成功。 如果此函式成功，則會傳回 TRUE;否則會傳回 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

此函式和 SetWindowDisplayAffinity 的設計目的是支援 Windows 7 特有的視窗內容保護功能。 此功能可讓應用程式保護自己的螢幕窗口內容，使其無法透過一組特定的公用操作系統功能和 API 擷取或複製。 不過，只有在桌面視窗管理員 (DWM) 撰寫桌面時，才能運作。

請務必注意，不同於數位版權管理 (DRM) 的安全性功能或實作，不保證使用 SetWindowDisplayAffinity 和 GetWindowDisplayAffinity，以及其他必要的功能，例如 DwmIsCompositionEnabled，將會嚴格保護窗口內容，如同有人拍攝螢幕相片的情況。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-window-l1-1-1 (在 Windows 8.1) 中引進

另請參閱

概念

Windows