Edit

PFND3DKMT_CHECKOCCLUSION callback function (d3dkmthk.h)

  • Article

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

Syntax

PFND3DKMT_CHECKOCCLUSION Pfnd3dkmtCheckocclusion;

NTSTATUS Pfnd3dkmtCheckocclusion(
  const D3DKMT_CHECKOCCLUSION *unnamedParam1
)
{...}

Parameters

unnamedParam1

pData [in]

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 a 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)

See also

D3DKMT_CHECKOCCLUSION