D3DKMTCheckOcclusion function (d3dkmthk.h)

The D3DKMTCheckOcclusion function verifies whether the client area of a window is occluded.

Syntax

NTSTATUS D3DKMTCheckOcclusion(
  [in] const D3DKMT_CHECKOCCLUSION *unnamedParam1
);

Parameters

[in] unnamedParam1

A pointer to a D3DKMT_CHECKOCCLUSION structure that describes parameters for checking occlusion.

Return value

D3DKMTCheckOcclusion returns one of the following values:

Return code Description
STATUS_SUCCESS The client area of the window is not occluded.
STATUS_GRAPHICS_PRESENT_OCCLUDED The client area of the window is occluded.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect.

This function might also return other NTSTATUS values.

Remarks

The handle to the window that is checked for occlusion must be valid. A window is not occluded if a part of its client area lies on an unowned video present network (VidPn) source, if its client area is an empty rectangular area (RECT), or if desktop composition is running.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

D3DKMT_CHECKOCCLUSION