Partager via

STRUCTURE VIDEOPARAMETERS (tvout.h)

  • Article

Le pilote de miniport vidéo reçoit un pointeur vers une structure VIDEOPARAMETERS dans le membre InputBuffer d’un VIDEO_REQUEST_PACKET lorsque la demande IOCTL est IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS. Selon le membre dwCommand de la structure VIDEOPARAMETERS, le pilote miniport doit obtenir ou définir le connecteur de télévision et les fonctionnalités de protection contre la copie de l’appareil.

Syntaxe

typedef struct _VIDEOPARAMETERS {
  GUID  Guid;
  ULONG dwOffset;
  ULONG dwCommand;
  ULONG dwFlags;
  ULONG dwMode;
  ULONG dwTVStandard;
  ULONG dwAvailableModes;
  ULONG dwAvailableTVStandard;
  ULONG dwFlickerFilter;
  ULONG dwOverScanX;
  ULONG dwOverScanY;
  ULONG dwMaxUnscaledX;
  ULONG dwMaxUnscaledY;
  ULONG dwPositionX;
  ULONG dwPositionY;
  ULONG dwBrightness;
  ULONG dwContrast;
  ULONG dwCPType;
  ULONG dwCPCommand;
  ULONG dwCPStandard;
  ULONG dwCPKey;
  ULONG bCP_APSTriggerBits;
  UCHAR bOEMCopyProtection[256];
} VIDEOPARAMETERS, *PVIDEOPARAMETERS, *LPVIDEOPARAMETERS;

Membres

Guid

Spécifie l’identificateur global unique (GUID) pour cette structure {02C62061-1097-11d1-920F-00A024DF156E}. Un pilote de miniport vidéo doit vérifier le GUID au début de la structure avant de traiter la structure.

dwOffset

Est réservé et doit être ignoré par le pilote de miniport vidéo.

dwCommand

Indique l’action à effectuer par le pilote. Ce membre peut être l’une des valeurs suivantes :

VP_COMMAND_GET

Le pilote miniport doit retourner toutes les fonctionnalités du connecteur TV de l’appareil, les paramètres actuels du connecteur TV, les fonctionnalités de protection contre la copie et les paramètres actuels de protection contre la copie en définissant les indicateurs appropriés dans dwFlags et en définissant les valeurs des membres qui correspondent à ces indicateurs définis.

VP_COMMAND_SET

Le pilote miniport doit définir le connecteur TV et le matériel de protection contre la copie en fonction des membres de cette structure qui correspondent aux indicateurs définis dans dwFlags.

dwFlags

Indique les membres de cette structure qui contiennent des données valides. Lorsque dwCommand est VP_COMMAND_GET, le pilote doit définir les bits appropriés dans ce membre pour indiquer dans quels membres correspondants il a retourné des données valides. Lorsque dwCommand est VP_COMMAND_SET, le pilote doit définir la fonctionnalité sur le matériel en fonction des valeurs dans les membres qui correspondent aux bits définis dans ce membre. Ce membre peut être un OR au niveau du bit des valeurs répertoriées dans la première colonne du tableau suivant.

Indicateur Membres correspondants Commandes
VP_FLAGS_BRIGHTNESS dwBrightness get/set
VP_FLAGS_CONTRAST dwContrast get/set
VP_FLAGS_COPYPROTECT dwCPType

dwCPCommand

dwCPStandard

dwCPKey

bCP_APSTriggerBits

bOEMCopyProtection

 get/set

set

get

set

set

get/set
VP_FLAGS_FLICKER dwFlickerFilter get/set
VP_FLAGS_MAX_UNSCALED dwMaxUnscaledX

dwMaxUnscaledY

 get

get
VP_FLAGS_OVERSCAN dwOverscanX

dwOverscanY

 get/set

get/set
VP_FLAGS_POSITION dwPositionX

dwPositionY

 get/set

get/set
VP_FLAGS_TV_MODE dwMode

dwAvailableModes

 get/set

get
VP_FLAGS_TV_STANDARD dwTVStandard

dwAvailableTVStandard

 get/set

get

dwMode

Spécifie le mode de lecture actuel. Ce membre est valide pour les commandes VP_COMMAND_SET et VP_COMMAND_GET, et peut être l’une des valeurs suivantes :

VP_MODE_TV_PLAYBACK

Décrit un ensemble optimal de champs pour la lecture vidéo, avec le filtre scintillement désactivé et l’affichage de la suranalyse activé.

VP_MODE_WIN_GRAPHICS

Décrit les paramètres d’affichage optimaux pour l’affichage Windows, avec le filtre de scintillement maximal activé et tout affichage de suranalyse désactivé.

dwTVStandard

Est la norme mondiale actuelle de la télévision. Ce membre est valide pour les commandes VP_COMMAND_SET et VP_COMMAND_GET, et peut être l’une des valeurs suivantes :

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwAvailableModes

Indique les modes de lecture dont l’appareil est capable. Ce membre n’est valide que pour la commande VP_COMMAND_GET et peut être au niveau du bit OR des valeurs suivantes :

VP_MODE_TV_PLAYBACK

VP_MODE_WIN_GRAPHICS

dwAvailableTVStandard

Spécifie toutes les normes mondiales de télévision disponibles. Ce membre n’est valide que pour la commande VP_COMMAND_GET et peut être au niveau du bit OR des valeurs suivantes :

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwFlickerFilter

Valeur en dixièmes de pourcentage qui indique l’état du filtre scintillement. Ce membre peut être une valeur comprise entre [0,1000], et est valide pour VP_COMMAND_GET et VP_COMMAND_SET.

dwOverScanX

Valeur en dixièmes de pour cent qui indique la quantité de suranalyse en x. Ce membre peut être une valeur comprise entre [0,1000], et est valide pour VP_COMMAND_GET et VP_COMMAND_SET.

dwOverScanY

Valeur en dixièmes de pour cent qui indique la quantité de suranalyse en y. Ce membre peut être une valeur comprise entre [0,1000], et est valide pour VP_COMMAND_GET et VP_COMMAND_SET.

dwMaxUnscaledX

Est la résolution x maximale que le téléviseur peut afficher sans avoir à mettre à l’échelle matérielle l’image vidéo. Le pilote miniport doit définir une valeur dans ce membre lorsque dwCommand est VP_COMMAND_GET. Ce membre n’est pas valide pour VP_COMMAND_SET.

dwMaxUnscaledY

Résolution y maximale que le téléviseur peut afficher sans avoir à mettre à l’échelle matérielle l’image vidéo. Le pilote miniport doit définir une valeur dans ce membre lorsque dwCommand est VP_COMMAND_GET. Ce membre n’est pas valide pour VP_COMMAND_SET.

dwPositionX

Valeur utilisée par le matériel pour déterminer la position x actuelle de l’image sur le téléviseur. Ce membre est spécifié en pixels et est valide pour les VP_COMMAND_GET et les VP_COMMAND_SET.

dwPositionY

Valeur utilisée par le matériel pour déterminer la position y actuelle de l’image sur le téléviseur. Ce membre est spécifié dans les lignes d’analyse et est valide pour les VP_COMMAND_GET et les VP_COMMAND_SET.

dwBrightness

Valeur de pourcentage qui indique le paramètre de luminosité sur le téléviseur. Ce membre peut être une valeur comprise entre [0 100], et est valide pour VP_COMMAND_GET et VP_COMMAND_SET.

dwContrast

Valeur de pourcentage qui indique le paramètre de contraste sur le téléviseur. Ce membre peut être une valeur comprise entre [0 100], et est valide pour VP_COMMAND_GET et VP_COMMAND_SET.

dwCPType

Spécifie le type de protection contre la copie pris en charge par l’appareil. Ce membre est valide pour les commandes VP_COMMAND_SET et VP_COMMAND_GET et peut être CP_TYPE_APS_TRIGGER.

dwCPCommand

Commande de protection contre la copie. Ce membre est valide uniquement pour la commande VP_COMMAND_SET et peut être l’une des valeurs suivantes :

VP_CP_CMD_ACTIVATE

Le pilote miniport doit activer la protection contre la copie et générer et retourner une clé de protection contre la copie unique dans dwCPKey.

VP_CP_CMD_CHANGE

Si la clé de protection contre la copie dans dwCPKey est valide, le pilote miniport doit modifier la protection contre la copie en fonction des données du déclencheur dans bCP_APSTriggerBits.

VP_CP_CMD_DEACTIVATE

Si la clé de protection contre la copie dans dwCPKey est valide, le pilote miniport doit désactiver la protection contre la copie.

dwCPStandard

Normes TV pour lesquelles les types de protection contre la copie sont disponibles. Ce membre n’est valide que pour la commande VP_COMMAND_GET et peut être au niveau du bit OR des valeurs suivantes :

VP_TV_STANDARD_NTSC_M

VP_TV_STANDARD_NTSC_M_J

VP_TV_STANDARD_NTSC_433

VP_TV_STANDARD_PAL_B

VP_TV_STANDARD_PAL_D

VP_TV_STANDARD_PAL_G

VP_TV_STANDARD_PAL_H

VP_TV_STANDARD_PAL_I

VP_TV_STANDARD_PAL_M

VP_TV_STANDARD_PAL_N

VP_TV_STANDARD_PAL_60

VP_TV_STANDARD_SECAM_B

VP_TV_STANDARD_SECAM_D

VP_TV_STANDARD_SECAM_G

VP_TV_STANDARD_SECAM_H

VP_TV_STANDARD_SECAM_K

VP_TV_STANDARD_SECAM_K1

VP_TV_STANDARD_SECAM_L

VP_TV_STANDARD_SECAM_L1

VP_TV_STANDARD_WIN_VGA

dwCPKey

Clé de protection contre la copie générée par le pilote qui est unique à cette instance du pilote. Ce membre est valide uniquement pour la commande VP_COMMAND_SET. Le pilote miniport génère et retourne cette clé lorsque dwCPCommand est défini sur VP_CP_CMD_ACTIVATE. L’appelant doit définir cette clé lorsque le champ dwCPCommand est VP_CP_CMD_DEACTIVATE ou VP_CP_CMD_CHANGE. Si l’appelant définit une clé incorrecte, le pilote ne doit pas modifier les paramètres actuels de protection contre la copie.

bCP_APSTriggerBits

Spécifie les données de bits de déclencheur du système de protection analogique dvd (APS). Les bits zéro et 1 sont valides. Ce membre est valide uniquement pour la commande VP_COMMAND_SET.

bOEMCopyProtection[256]

Données de protection contre la copie spécifiques à OEM. Ce membre est valide pour les commandes VP_COMMAND_SET et VP_COMMAND_GET.

Configuration requise

Condition requise Valeur
En-tête tvout.h (inclure Tvout.h)

Voir aussi

IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS

VIDEO_REQUEST_PACKET