IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

  • Artikel

Führt einen Anzeigegeräteschalter aus, eine Zustandsänderung, bei der das Videosignal, das an ein Anzeigegerät geht, an ein anderes, möglicherweise einen anderen Typ des Anzeigegeräts gesendet wird. Nach dem Schalter des Anzeigegeräts kann das Videosignal an ein oder beide Anzeigegeräte gesendet werden. Wenn der Videoporttreiber eine Benachrichtigung zum Wechseln der Anzeigegeräte empfängt, sendet er diese IOCTL an den Miniporttreiber. Normalerweise wird diese IOCTL gesendet, nachdem IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION anzeigt, dass der Miniporttreiber bereit ist, den Umstieg vorzunehmen. Wenn der Miniporttreiber die Anzeigegeräte wechseln kann, sollte er dies tun und das Statuselement von StatusBlock auf NO_ERROR festlegen.

Wenn der Miniporttreiber nicht in der Lage ist, den Anzeigegeräteschalter auszuführen, kann er den Statuselement von StatusBlock auf einen entsprechenden Fehlerwert festlegen (beschrieben im Abschnitt StatusBlock ), und die Anforderung nicht behandeln. Obwohl diese Anforderung optional ist, wird dringend empfohlen, dass der Miniporttreiber diese Anforderung verarbeitet. Wenn dies nicht der Fall ist, wird ein Aufruf des BIOS erzwungen, um den Schalter des Anzeigegeräts zu behandeln, was sehr ineffizient sein kann und sich negativ auf die Robustheit des Systems auswirken kann.

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION ist synchron. Nachdem diese IOCTL gesendet wurde, sollte IOCTL_VIDEO_GET_CHILD_STATE den neuen Zustand widerspiegeln.

Diese Anforderung ist modal.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der VRP InputBuffer enthält eine VIDEO_CHILD_STATE_CONFIGURATION-Struktur .

Ausgabepuffer

Keine

Statusblock

Der Miniporttreiber legt das Statuselement auf NO_ERROR fest, wenn er den Anzeigegeräteschalter ausführen kann. Wenn er diesen Vorgang nicht ausführen kann, kann der Miniporttreiber Status auf einen entsprechenden Fehlerwert festlegen oder gar nichts tun.

Anforderungen

Anforderung Wert
Header ntddvdeo.h

Weitere Informationen

IOCTL_VIDEO_GET_CHILD_STATE

IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION

VIDEO_CHILD_STATE_CONFIGURATION