VideoPortDDCMonitorHelper, fonction (video.h)

2025-02-07

Interroge un moniteur pour informations de EDID à l’aide du protocole DDC.

Syntaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortDDCMonitorHelper(
  [in]      IN PVOID      HwDeviceExtension,
  [in]      IN PVOID      DDCControl,
  [in, out] IN OUT PUCHAR EdidBuffer,
  [in]      IN ULONG      EdidBufferSize
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] DDCControl

Pointeur vers une structure DDC_CONTROL.

[in, out] EdidBuffer

Pointeur vers une mémoire tampon dans laquelle le pilote de port vidéo retourne la structure EDID. Pour les appareils ACPI, les quatre premiers octets sont prédéfinis par le pilote de port vidéo pour indiquer une tentative de lecture du EDID.

[in] EdidBufferSize

Taille en octets de la mémoire tampon vers laquelle EdidBuffer points.

Valeur de retour

VideoPortDDCMonitorHelper retourne TRUE en cas de réussite.

Remarques

note

Cette fonction existait avant la version de Windows XP, mais elle a été modifiée.

La fonction du pilote miniport vidéo HwVidGetVideoChildDescriptor peut appeler VideoPortDDCMonitorHelper pour obtenir de l’aide pour lire la structure EDID à partir d’un moniteur conforme DDC2. VideoPortDDCMonitorHelper implémente les détails de la lecture de la structure EDID en fonction de la spécification I²C, mais doit rappeler le pilote de miniport vidéo pour lire et écrire des bits de données individuels dans l’horloge série I²C et les lignes de données.

Les quatre fonctions, implémentées par le pilote de miniport vidéo, qui lisent et écrivent des bits individuels dans l’horloge I²C et les lignes de données sont ReadClockLine, ReadDataLine, WriteClockLineet WriteDataLine. Lorsque le pilote de miniport vidéo appelle VideoPortDDCMonitorHelper, il fournit des pointeurs vers ces quatre fonctions dans DDCControl->I2CCallbacks.

Le EDID peut être obtenu à l’aide de la méthode ACPI_METHOD_OUTPUT_DDC dont l’alias est défini dans Dispmprt.h. Cette méthode est requise pour les disques LCD intégrés qui n’ont pas d’autre mécanisme standard pour retourner des données EDID.

Dans une mémoire tampon de 256 octets, un appelant de cette fonction peut recevoir :

EDID d’un octet de 128 octets
Deux EDID de 128 octets
Un EDID de 256 octets (à partir de l’affichage P&D)
Aucun EDID

L’appelant doit toujours demander les 256 octets complets, car il est impossible de lire uniquement le deuxième bloc de 128 octets du segment.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	video.h (include Video.h)
bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL