Hardware Dev Center

Collapse the table of content
Expand the table of content
Expand Minimize

D3DKMTPollDisplayChildren function

The D3DKMTPollDisplayChildren function queries for connectivity status of all child devices of the given adapter.

Syntax


NTSTATUS APIENTRY D3DKMTPollDisplayChildren(
  _In_ const D3DKMT_POLLDISPLAYCHILDREN *pData
);

Parameters

pData [in]

A pointer to a D3DKMT_POLLDISPLAYCHILDREN structure that describes the parameters for querying for connectivity status of the adapter's child devices.

Return value

D3DKMTPollDisplayChildren returns one of the following values:

Return codeDescription
STATUS_SUCCESS

Connectivity status was successfully retrieved.

STATUS_DEVICE_REMOVED

The graphics adapter was stopped.

 

This function might also return other NTSTATUS values.

Remarks

The OpenGL installable client driver (ICD) calls D3DKMTPollDisplayChildren to query for connectivity status of all of the adapter's child devices. The ICD sets the NonDestructiveOnly member of D3DKMT_POLLDISPLAYCHILDREN to indicate whether D3DKMTPollDisplayChildren should be destructive (that is, cause visual artifacts). For typical polling, the ICD should set NonDestructiveOnly to TRUE to prevent the screen from flickering.

New child devices are enumerated to the Plug and Play (PnP) manager when PnP detects them. The devices are then listed in the device manager. If PnP determines that a child device was removed, the device is reported as a surprise removal.

Requirements

Target platform

Universal

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmthk.h (include D3dkmthk.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

D3DKMT_POLLDISPLAYCHILDREN

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft