Condividi tramite

Struttura VIDEOPARAMETERS (tvout.h)

  • Articolo

Il driver miniport video riceve un puntatore a una struttura VIDEOPARAMETERS nel membro InputBuffer di un VIDEO_REQUEST_PACKET quando la richiesta IOCTL è IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS. A seconda del membro dwCommand della struttura VIDEOPARAMETERS, il driver miniport deve ottenere o impostare le funzionalità di protezione del connettore televisivo e della copia del dispositivo.

Sintassi

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;

Members

Guid

Specifica l'identificatore univoco globale (GUID) per questa struttura {02C62061-1097-11d1-920F-00A024DF156E}. Un driver miniport video deve verificare il GUID all'inizio della struttura prima di elaborare la struttura.

dwOffset

È riservato e deve essere ignorato dal driver miniport video.

dwCommand

Indica l'azione da eseguire dal driver. Questo membro può essere uno dei valori seguenti:

VP_COMMAND_GET

Il driver miniport deve restituire tutte le funzionalità del connettore TV del dispositivo, le impostazioni correnti del connettore TV, le funzionalità di protezione delle copie e le impostazioni di protezione della copia correnti impostando i flag appropriati in dwFlags e impostando i valori dei membri che corrispondono a tali flag impostati.

VP_COMMAND_SET

Il driver miniport deve impostare il connettore TV e copiare l'hardware di protezione in base ai membri di questa struttura che corrispondono ai flag impostati in dwFlags.

dwFlags

Indica quali membri di questa struttura contengono dati validi. Quando dwCommand è VP_COMMAND_GET, il driver deve impostare i bit appropriati in questo membro per indicare in quali membri corrispondenti ha restituito dati validi. Quando dwCommand è VP_COMMAND_SET, il driver deve impostare la funzionalità sull'hardware in base ai valori dei membri che corrispondono ai bit impostati in questo membro. Questo membro può essere un OR bit per bit dei valori elencati nella prima colonna della tabella seguente.

Contrassegno Membri corrispondenti Comandi
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

Specifica la modalità di riproduzione corrente. Questo membro è valido per i comandi VP_COMMAND_SET e VP_COMMAND_GET e può essere uno dei valori seguenti:

VP_MODE_TV_PLAYBACK

Descrive un set ottimale di campi per la riproduzione video, con il filtro flicker disattivato e la visualizzazione overscan.

VP_MODE_WIN_GRAPHICS

Descrive le impostazioni di visualizzazione ottimali per la visualizzazione di Windows, con il filtro di flicker massimo su e qualsiasi visualizzazione overscan disattivata.

dwTVStandard

È lo standard televisivo mondiale corrente. Questo membro è valido per i comandi VP_COMMAND_SET e VP_COMMAND_GET e può essere uno dei valori seguenti:

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

Indica che le modalità di riproduzione del dispositivo sono in grado di. Questo membro è valido solo per il comando VP_COMMAND_GET e può essere un OR bit per bit dei valori seguenti:

VP_MODE_TV_PLAYBACK

VP_MODE_WIN_GRAPHICS

dwAvailableTVStandard

Specifica tutti gli standard televisivi mondiali disponibili. Questo membro è valido solo per il comando VP_COMMAND_GET e può essere un OR bit per bit dei valori seguenti:

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

Valore in decimi di percentuale che indica lo stato del filtro flicker. Questo membro può essere un valore compreso tra [0.1000]e è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwOverScanX

Valore in decimi di percentuale che indica la quantità di overscan in x. Questo membro può essere un valore compreso tra [0.1000]e è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwOverScanY

Valore in decimi di percentuale che indica la quantità di overscan in y. Questo membro può essere un valore compreso tra [0.1000]e è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwMaxUnscaledX

È la risoluzione x massima che la TV può visualizzare senza avere la scalabilità hardware dell'immagine video. Il driver miniport deve impostare un valore in questo membro quando dwCommand è VP_COMMAND_GET. Questo membro non è valido per VP_COMMAND_SET.

dwMaxUnscaledY

È la risoluzione massima y che la TV può visualizzare senza avere la scalabilità hardware dell'immagine video. Il driver miniport deve impostare un valore in questo membro quando dwCommand è VP_COMMAND_GET. Questo membro non è valido per VP_COMMAND_SET.

dwPositionX

Valore utilizzato dall'hardware per determinare la posizione x corrente dell'immagine nella TV. Questo membro viene specificato in pixel ed è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwPositionY

Valore utilizzato dall'hardware per determinare la posizione corrente dell'immagine nella TV. Questo membro viene specificato nelle righe di analisi ed è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwBrightness

Valore percentuale che indica l'impostazione di luminosità sulla TV. Questo membro può essere un valore compreso tra [0.100]e è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwContrast

Valore percentuale che indica l'impostazione di contrasto sulla TV. Questo membro può essere un valore compreso tra [0.100]e è valido sia per VP_COMMAND_GET che per VP_COMMAND_SET.

dwCPType

Specifica il tipo di protezione della copia supportata dal dispositivo. Questo membro è valido sia per i comandi VP_COMMAND_SET che per i VP_COMMAND_GET e può essere CP_TYPE_APS_TRIGGER.

dwCPCommand

Comando di protezione della copia. Questo membro è valido solo per il comando VP_COMMAND_SET e può essere uno dei valori seguenti:

VP_CP_CMD_ACTIVATE

Il driver miniport deve attivare la protezione della copia e generare e restituire una chiave di protezione di copia univoca in dwCPKey.

VP_CP_CMD_CHANGE

Se la chiave di protezione della copia in dwCPKey è valida, il driver miniport deve modificare la protezione della copia in base ai dati del trigger in bCP_APSTriggerBits.

VP_CP_CMD_DEACTIVATE

Se la chiave di protezione della copia in dwCPKey è valida, il driver miniport deve disattivare la protezione della copia.

dwCPStandard

Gli standard TV per i quali sono disponibili i tipi di protezione delle copie. Questo membro è valido solo per il comando VP_COMMAND_GET e può essere un OR bit per bit dei valori seguenti:

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

Chiave di protezione della copia generata dal driver univoca per questa istanza del driver. Questo membro è valido solo per il comando VP_COMMAND_SET. Il driver miniport genera e restituisce questa chiave quando dwCPCommand è impostato su VP_CP_CMD_ACTIVATE. Il chiamante deve impostare questa chiave quando il campo dwCPCommand è VP_CP_CMD_DEACTIVATE o VP_CP_CMD_CHANGE. Se il chiamante imposta una chiave non corretta, il driver non deve modificare le impostazioni di protezione della copia correnti.

bCP_APSTriggerBits

Specifica i dati del trigger APS (DVD Analog Protection System). I bit zero e 1 sono validi. Questo membro è valido solo per il comando VP_COMMAND_SET.

bOEMCopyProtection[256]

Dati di protezione della copia specifici dell'OEM. Questo membro è valido sia per i comandi VP_COMMAND_SET che per i comandi VP_COMMAND_GET.

Requisiti

Requisito Valore
Intestazione tvout.h (include Tvout.h)

Vedi anche

IOCTL_VIDEO_HANDLE_VIDEOPARAMETERS

VIDEO_REQUEST_PACKET