Expand Minimize

IOCTL_VIDEO_GET_CHILD_STATE control code

Determines whether a child device is currently enabled. Although miniport driver support for this modal request is optional, it is highly recommended. Otherwise, Windows 2000 and later must call the BIOS to perform the operation, which is very inefficient and can adversely affect system robustness. If the BIOS cannot handle this request, then Windows 2000 or later considers the child device to be active.

Input Parameters

The VRP InputBuffer contains a pointer to a ULONG, containing the index of the child device, as specified in HwVidGetVideoChildDescriptor.

Output Parameters

The video miniport driver returns a ULONG in the VRP OutputBuffer that can be a combination of the following flags:

ValueMeaning

VIDEO_CHILD_ACTIVE

The child device is active.

VIDEO_CHILD_DETACHED

The child device is detached from the view. This flag is used in DualView implementations to indicate the logical relationships of child devices. See Supporting DualView (Windows 2000 Model) for more information.

VIDEO_CHILD_NOPRUNE_FREQ

The child device can drive an image at any refresh rate, regardless of its EDID setting.

This flag is used for mode pruning. By default, Windows 2000 and later perform mode pruning for each active child. When the miniport driver wants to prevent the operating system from performing mode pruning on specific child devices, however, it should use this flag.

VIDEO_CHILD_NOPRUNE_SIZE

The child device can drive an image of any size, regardless of its EDID setting.

This flag is used for mode pruning. By default, Windows 2000 and later perform mode pruning for each active child. When the miniport driver wants to prevent the operating system from performing mode pruning on specific child devices, however, it should use this flag.

 

I/O Status Block

The video miniport driver sets the Information member of the STATUS_BLOCK structure to sizeof(ULONG).

Requirements

Header

Ntddvdeo.h (include Ntddvdeo.h)

See also

HwVidGetVideoChildDescriptor
STATUS_BLOCK

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft