IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

Статья
02/29/2024

Выполняет переключение устройства отображения— изменение состояния, при котором видеосигнал, передаваемый на одно устройство отображения, отправляется другому, возможно, другому типу устройства отображения. После переключения устройства отображения видеосигнал может быть отправлен на одно или оба устройства отображения. Когда драйвер видеопорта получает уведомление о переключении устройств отображения, он отправляет этот IOCTL драйверу мини-порта. Как правило, этот IOCTL отправляется после IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION указывает, что драйвер мини-порта готов к переключении. Если драйвер мини-порта может переключать устройства отображения, он должен сделать это и задать для элемента StatusBlock значение NO_ERROR.

Если драйвер мини-порта не может выполнять переключение устройства отображения, он может задать для элемента StatusBlock соответствующее значение ошибки (описано в разделе StatusBlock), выбрав не обрабатывать запрос. Хотя этот запрос является необязательным, настоятельно рекомендуется, чтобы драйвер мини-порта обработал этот запрос. Если это не сделать, вызов BIOS для обработки переключателя устройства отображения может быть очень неэффективным и может отрицательно сказаться на надежности системы.

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION является синхронным. После отправки этого IOCTL IOCTL_VIDEO_GET_CHILD_STATE должно отражать новое состояние.

Этот запрос является модальным.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

VRP InputBuffer содержит VIDEO_CHILD_STATE_CONFIGURATION структуру.

Выходной буфер

None

Блок состояния

Драйвер мини-порта задает элементу Status значение NO_ERROR, если он может выполнять переключение устройства дисплея. Если он не может выполнить эту операцию, драйвер мини-порта может задать для параметра Состояние соответствующее значение ошибки или вообще ничего не делать.