Struttura DDVIDEOPORTINFO (dvp.h)
La struttura DDVIDEOPORTINFO descrive come il driver deve trasferire i dati video a una superficie (o a superfici); DDVIDEOPORTINFO è membro della struttura DD_VIDEOPORT_LOCAL .
Sintassi
typedef struct _DDVIDEOPORTINFO {
DWORD dwSize;
DWORD dwOriginX;
DWORD dwOriginY;
DWORD dwVPFlags;
RECT rCrop;
DWORD dwPrescaleWidth;
DWORD dwPrescaleHeight;
LPDDPIXELFORMAT lpddpfInputFormat;
LPDDPIXELFORMAT lpddpfVBIInputFormat;
LPDDPIXELFORMAT lpddpfVBIOutputFormat;
DWORD dwVBIHeight;
ULONG_PTR dwReserved1;
ULONG_PTR dwReserved2;
} *LPDDVIDEOPORTINFO, DDVIDEOPORTINFO;
Members
dwSize
Specifica le dimensioni in byte della struttura. Questo membro deve essere inizializzato prima dell'uso della struttura.
dwOriginX
Indica la posizione x dei dati video all'interno della superficie, in pixel. Questo offset si applica a tutte le superfici quando viene richiesta la scalabilità automatica.
dwOriginY
Indica la posizione y dei dati video all'interno della superficie, in pixel. Questo offset si applica a tutte le superfici quando viene richiesta la scalabilità automatica.
dwVPFlags
Indica un set di flag che specificano come il driver deve trasferire i dati video. Questo membro può essere un OR bit per bit dei valori seguenti:
| Contrassegno | Significato |
|---|---|
| DDVP_AUTOFLIP | Eseguire il capovolgimento automatico. Il capovolgimento automatico viene eseguito tra la superficie di sovrapposizione collegata alla porta video hardware e le superfici sovrapposte associate alla superficie. L'ordine di capovolgimento è l'ordine in cui sono state associate le superfici sovrapposte. |
| DDVP_CONVERT | I dati video e la superficie di destinazione hanno formati diversi. Il driver deve convertire i dati video nel formato della superficie di destinazione. |
| DDVP_CROP | Il driver deve ritagliare sia i dati video che VBI usando il rettangolo nel membro rCrop . |
| DDVP_IGNOREVBIXCROP | Il driver deve ignorare le coordinate di ritaglio a sinistra e destra durante il ritaglio dei dati VBI. |
| DDVP_INTERLEAVE | I campi interlacciati di dati video e VBI devono essere interleavedi in memoria. |
| DDVP_MIRRORLEFTRIGHT | I dati video devono essere mirrorati da sinistra a destra mentre vengono scritti nel buffer dei fotogrammi. |
| DDVP_MIRRORUPDOWN | I dati video devono essere mirrorati in alto verso il basso mentre vengono scritti nel buffer dei fotogrammi. |
| DDVP_NOINTERLEAVE | Se il flag di DDVP_INTERLEAVE è impostato, il driver deve interlezzare solo i dati video; ovvero, il driver non deve interlezzare i dati VBI. |
| DDVP_OVERRIDEBOBWEAVE | Le decisioni bob e weave non devono essere sostituite da altre interfacce. Se questo flag è impostato, Microsoft DirectDraw non consente a un driver in modalità kernel di usare la funzionalità di trasporto video in modalità kernel per cambiare l'hardware tra le modalità bob e weave. |
| DDVP_PRESCALE | Eseguire la scalabilità preliminare/zoom in base ai membri dwPrescaleWidth e dwPrescaleHeight . Il driver deve prescalare solo i dati video se DDVP_VBINOSCALE è impostato; in caso contrario, deve prescalare sia i dati video che VBI. |
| DDVP_SKIPEVENFIELDS | Ignorare l'input dei campi pari per i dati video e VBI. |
| DDVP_SKIPODDFIELDS | Ignorare l'input di campi dispari per i dati video e VBI. |
| DDVP_SYNCMASTER | Eseguire l'unità grafica VSYNCs usando la porta video hardware VSYNCs. |
| DDVP_VBICONVERT | La struttura DDPIXELFORMAT in cui i punti membro lpddpfVBIOutputFormat contengono dati che devono essere usati per convertire i dati all'interno dell'intervallo di spaziatura verticale. |
| DDVP_VBINOSCALE | I dati all'interno dell'intervallo di spaziatura verticale non devono essere ridimensionati. |
rCrop
Specifica una struttura RECT che specifica un rettangolo di ritaglio in pixel. Questo membro contiene un rettangolo valido quando il flag di DDVP_CROP è impostato nel membro dwVPFlags .
dwPrescaleWidth
Specifica la larghezza in pixel a cui devono essere prescalati o zoomati i dati video e VBI. Ad esempio, se i dati video sono a 720 pixel e il client richiede la larghezza in metà, il client specifica 360 in dwPrescaleWidth. Questo membro contiene una larghezza valida quando il flag di DDVP_PRESCALE è impostato nel membro dwVPFlags .
dwPrescaleHeight
Specifica l'altezza in pixel in cui i dati video e VBI devono essere prescalati o zoomati. Ad esempio, se i dati video sono di 240 pixel e il client richiede la larghezza in metà, il client specifica 120 in dwPrescaleHeight. Questo membro contiene una larghezza valida quando il flag di DDVP_PRESCALE è impostato nel membro dwVPFlags .
lpddpfInputFormat
Punta a una struttura DDPIXELFORMAT che specifica il formato dei dati video da scrivere nell'oggetto VPE (Video Port Extensions). Questo formato può essere diverso dal formato della superficie di destinazione se l'oggetto VPE esegue una conversione.
lpddpfVBIInputFormat
Punta a una struttura DDPIXELFORMAT che specifica il formato di input dei dati all'interno dell'intervallo di spaziatura verticale.
lpddpfVBIOutputFormat
Punta a una struttura DDPIXELFORMAT che specifica il formato di output dei dati all'interno dell'intervallo di vuoto verticale.
dwVBIHeight
Specifica il numero di righe di dati all'interno dell'intervallo di spaziatura verticale.
dwReserved1
Riservato per l'uso del sistema e deve essere ignorato dal driver.
dwReserved2
Riservato per l'uso del sistema e deve essere ignorato dal driver.
Commenti
Tutti i membri di questa struttura vengono impostati dal client e il driver non deve mai modificarli. Il client è in genere il mixer di sovrapposizione.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dvp.h (includere Dvp.h) |