IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

  • Article

Effectue un commutateur de périphérique d’affichage, un changement d’état dans lequel le signal vidéo envoyé à un périphérique d’affichage est envoyé à un autre, éventuellement un autre type de périphérique d’affichage. Une fois le périphérique d’affichage basculé, le signal vidéo peut être envoyé à l’un ou aux deux appareils d’affichage. Lorsque le pilote de port vidéo reçoit une notification pour changer de périphérique d’affichage, il envoie ce IOCTL au pilote miniport. Normalement, ce IOCTL est envoyé après IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION indique que le pilote miniport est prêt à effectuer le changement. Si le pilote miniport est capable de changer de périphérique d’affichage, il doit le faire et définir le membre Status de StatusBlock sur NO_ERROR.

Si le pilote miniport n’est pas en mesure d’effectuer le commutateur de périphérique d’affichage, il peut définir le membre Status de StatusBlock sur une valeur d’erreur appropriée (décrite dans la section StatusBlock ), en choisissant de ne pas gérer la demande. Bien que cette demande soit facultative, il est vivement recommandé que le pilote miniport gère cette demande. Si vous ne le faites pas, un appel au BIOS doit gérer le commutateur du périphérique d’affichage, ce qui peut être très inefficace et avoir un effet négatif sur la robustesse du système.

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION est synchrone. Une fois ce IOCTL envoyé, IOCTL_VIDEO_GET_CHILD_STATE doit refléter le nouvel état.

Cette requête est modale.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Le inputBuffer VRP contient une structure VIDEO_CHILD_STATE_CONFIGURATION .

Mémoire tampon de sortie

None

Bloc d’état

Le pilote miniport définit le membre Status sur NO_ERROR s’il est capable d’effectuer le commutateur de périphérique d’affichage. S’il n’est pas en mesure d’effectuer cette opération, le pilote miniport peut définir Status sur une valeur d’erreur appropriée, ou ne rien faire du tout.

Configuration requise

Condition requise Valeur
En-tête ntddvdeo.h

Voir aussi

IOCTL_VIDEO_GET_CHILD_STATE

IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION

VIDEO_CHILD_STATE_CONFIGURATION