Hardware Dev Center

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

DxgkDdiQueryChildStatus routine

The DxgkDdiQueryChildStatus function returns the status of an individual child device of a display adapter.

Syntax


PDXGKDDI_QUERY_CHILD_STATUS DxgkDdiQueryChildStatus;

NTSTATUS* DxgkDdiQueryChildStatus(
  _In_    const PVOID              MiniportDeviceContext,
  _Inout_       PDXGK_CHILD_STATUS ChildStatus,
  _In_          BOOLEAN            NonDestructiveOnly
)
{ ... }

Parameters

MiniportDeviceContext [in]

A handle to a context block associated with a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.

ChildStatus [in, out]

A pointer to a DXGK_CHILD_STATUS structure. The caller supplies ChildStatus->Type and ChildStatus->ChildUid. On return, the remaining structure member (a union) receives the requested status.

NonDestructiveOnly [in]

A BOOLEAN value that specifies whether the display miniport driver is permitted to determine the requested status in a way that causes visual artifacts. If the caller sets this parameter to TRUE, then the display miniport driver is not permitted to cause artifacts. If the caller sets this parameter to FALSE, then the display miniport driver is permitted to cause artifacts.

Return value

DxgkDdiQueryChildStatus returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

During initialization, the display port driver calls DxgkDdiQueryChildRelations to get a list of devices that are children of the display adapter represented by MiniportDeviceContext. Then for each child that has an HPD awareness value of HpdAwarenessPolled or HpdAwarenessInterruptible, the display port driver calls DxgkDdiQueryChildStatus to determine whether the child currently has hardware (for example a monitor) connected to it.

DxgkDdiQueryChildStatus must perform the following actions:

  • If ChildStatus->Type is equal to StatusConnection, return a Boolean value in ChildStatus->HotPlug.Connected. Return TRUE if the child device identified by ChildStatus->ChildUid has external hardware connected to it; otherwise return FALSE.

  • If ChildStatus->Type is equal to StatusRotation, return (in ChildStatus->Rotation.Angle) the angle of rotation for the display connected to the child device identified by ChildStatus->ChildUid.

DxgkDdiQueryChildStatus should be made pageable.

Requirements

Target platform

Desktop

Version

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

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL

See also

DXGK_CHILD_STATUS
DXGK_CHILD_STATUS_TYPE
DxgkDdiQueryChildRelations

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft