Partager via


IOCTL_VIDEO_VALIDATE_CHILD_STATE_CONFIGURATION IOCTL (ntddvdeo.h)

Interroge le pilote miniport pour déterminer s’il est prêt pour un commutateur d’appareil d’affichage. Ce commutateur est un changement d’état dans lequel le signal vidéo qui va à un appareil d’affichage est envoyé à un autre, éventuellement différent type d’appareil d’affichage. Une fois le commutateur de l’appareil d’affichage basculé, le signal vidéo peut être envoyé à un ou les deux appareils d’affichage. Lorsque le pilote de port vidéo reçoit une demande pour changer d’appareil d’affichage (par exemple, une touche d’accès rapide enfoncée), il envoie cette IOCTL au pilote miniport vidéo. La valeur retournée par le pilote miniport indique si le pilote de port vidéo doit continuer avec le commutateur d’appareil d’affichage.

Lorsque le pilote miniport reçoit cette demande, il doit indiquer qu’il a correctement géré la requête par :

  • Placer la valeur appropriée (décrite dans la section Sortie) dans OutputBuffer
  • Retour NO_ERROR dans le membre Status du StatusBlock du VRP
Le pilote de miniport vidéo exécute un commutateur d’appareil d’affichage validé lorsqu’il reçoit une demande de IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION.

Le pilote miniport n’est pas nécessaire pour gérer ce IOCTL modal. Le pilote de port vidéo interprète une valeur de retour par défaut du pilote miniport comme autorisation de continuer avec le commutateur d’appareil d’affichage.

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

Le pilote miniport retourne 1 dans le VRP OutputBuffer si le pilote de port vidéo doit continuer avec le commutateur d’appareil d’affichage ; sinon, le pilote retourne 0 dans le VRP OutputBuffer.

Bloc d’état

Le pilote miniport stocke NO_ERROR dans Status s’il a réussi à gérer ce IOCTL ; sinon, le pilote stocke un code d’erreur vidéo approprié dans Status. Dans les deux cas, le pilote miniport définit l'Information membre de la structure STATUS_BLOCK sur taille de(ULONG).

Exigences

Exigence Valeur
d’en-tête ntddvdeo.h

Voir aussi

IOCTL_VIDEO_SET_CHILD_STATE_CONFIGURATION

STATUS_BLOCK

VIDEO_CHILD_STATE_CONFIGURATION