D3DKMT_PRESENTFLAGS struttura (d3dkmthk.h)
La struttura D3DKMT_PRESENTFLAGS identifica come eseguire un'operazione presente.
Sintassi
typedef struct _D3DKMT_PRESENTFLAGS {
union {
struct {
UINT Blt : 1;
UINT ColorFill : 1;
UINT Flip : 1;
UINT FlipDoNotFlip : 1;
UINT FlipDoNotWait : 1;
UINT FlipRestart : 1;
UINT DstRectValid : 1;
UINT SrcRectValid : 1;
UINT RestrictVidPnSource : 1;
UINT SrcColorKey : 1;
UINT DstColorKey : 1;
UINT LinearToSrgb : 1;
UINT PresentCountValid : 1;
UINT Rotate : 1;
UINT PresentToBitmap : 1;
UINT RedirectedFlip : 1;
UINT RedirectedBlt : 1;
UINT FlipStereo : 1;
UINT FlipStereoTemporaryMono : 1;
UINT FlipStereoPreferRight : 1;
UINT BltStereoUseRight : 1;
UINT PresentHistoryTokenOnly : 1;
UINT PresentRegionsValid : 1;
UINT PresentDDA : 1;
UINT ProtectedContentBlankedOut : 1;
UINT RemoteSession : 1;
UINT CrossAdapter : 1;
UINT DurationValid : 1;
UINT PresentIndirect : 1;
UINT PresentHMD : 1;
#if ...
UINT Reserved : 2;
#elif
UINT Reserved : 6;
#else
UINT Reserved : 15;
#endif
};
UINT Value;
};
} D3DKMT_PRESENTFLAGS;
Members
Blt
Valore UINT che specifica se trasferire i dati bit-block (bitblt) nella superficie primaria. Questo flag di campo a bit può essere usato con i flag di bit DstRectValid e SrcRectValid .
L'impostazione di questo membro equivale a impostare il primo bit del membro Valore a 32 bit (0x00000001).
ColorFill
Valore UINT che specifica se eseguire un bitblt di riempimento del colore nella superficie primaria usando il valore nel membro Color della struttura D3DKMT_PRESENT . Questo flag di campo bit può essere usato con il flag di bit DstRectValid bit-field.
L'impostazione di questo membro equivale a impostare il secondo bit del membro Valore a 32 bit (0x00000002).
Flip
Valore UINT che specifica se passare a una nuova superficie.
L'impostazione di questo membro equivale a impostare il terzo bit del membro Valore a 32 bit (0x00000004).
FlipDoNotFlip
Valore UINT che specifica se inserire attese in coda nel flusso di rendering. L'impostazione di questo membro indica di passare alla stessa superficie attualmente analizzata.
L'impostazione di questo membro equivale a impostare il quarto bit del membro Valore a 32 bit (0x00000008).
FlipDoNotWait
Un valore UINT che specifica se il driver client installabile OpenGL (ICD) richiede che l'operazione presente attenda il numero di superfici capovolgibili in coda che siano inferiori a un determinato limite prima dell'avvio dell'operazione. L'impostazione di questo membro indica che l'ICD non richiede l'attesa. Il limite predefinito per il numero di superfici capovolte in coda è tre.
L'impostazione di questo membro equivale a impostare il quinto bit del membro Valore a 32 bit (0x00000010).
FlipRestart
Valore UINT che specifica se riavviare un capovolgimento a una nuova superficie.
L'impostazione di questo membro equivale a impostare il sesto bit del membro Valore a 32 bit (0x00000020).
DstRectValid
Valore UINT che specifica se il bitblt usa un'area rettangolare di destinazione.
L'impostazione di questo membro equivale a impostare il settimo bit del membro Value a 32 bit (0x00000040).
SrcRectValid
Valore UINT che specifica se il bitblt usa un'area rettangolare di origine.
L'impostazione di questo membro equivale a impostare l'ottavo bit del membro Valore a 32 bit (0x00000080).
RestrictVidPnSource
Valore UINT che specifica se limitare il bitblt. Se il membro hWindow è NULL, il membro VidPnSourceId della struttura D3DKMT_PRESENT indica quale output viene indirizzato a bitblt a schermo intero; se hWindow non è NULL, VidPnSourceId indica quale output limitare il bitblt a finestra.
L'impostazione di questo membro equivale a impostare il nono bit del membro Valore a 32 bit (0x00000100).
SrcColorKey
Valore UINT che specifica se eseguire la chiave del colore di origine usando il valore nel membro Color della struttura D3DKMT_PRESENT . Ovvero, qualsiasi pixel nell'area di origine che corrisponde alla chiave di colore non deve essere copiato nell'area di destinazione e tutti i pixel di origine che non corrispondono alla chiave di colore devono essere copiati.
L'impostazione di questo membro equivale a impostare il decimo bit del membro Valore a 32 bit (0x00000200).
DstColorKey
Valore UINT che specifica se eseguire il tasto colore di destinazione usando il valore nel membro Color di D3DKMT_PRESENT. Ovvero, qualsiasi pixel nell'area di destinazione che corrisponde alla chiave di colore deve essere sostituito con il pixel corrispondente dall'area di origine e tutti i pixel di destinazione che non corrispondono alla chiave di colore non devono essere sostituiti.
L'impostazione di questo membro equivale a impostare l'undicesimo bit del membro Valore a 32 bit (0x00000400).
LinearToSrgb
Valore UINT che specifica se convertire l'origine con formattazione lineare in formato sRGB durante l'operazione di copia. il formato sRGB è corretto. Per altre informazioni sul formato sRGB, vedere il sito Web sRGB .
L'impostazione di questo membro equivale a impostare il dodicesimo bit del membro Valore a 32 bit (0x00000800).
PresentCountValid
Valore UINT che specifica se il valore impostato nel membro PresentCount della struttura D3DKMT_PRESENT è valido.
L'impostazione di questo membro equivale a impostare il tredicesimo bit del membro Valore a 32 bit (0x00001000).
[in] Rotate
Valore UINT che specifica se ruotare i dati della presentazione in modo che corrispondano all'orientamento corrente dello schermo durante il trasferimento a blocchi di bit della presentazione (bitblt). L'orientamento corrente dello schermo è impostato nel membro Rotazione di una struttura D3DKMDT_VIDPN_PRESENT_PATH_TRANSFORMATION , impostata nel membro ContentTransformationdella struttura D3DKMDT_VIDPN_PRESENT_PATH per il percorso presente nel video.
Il driver miniport visualizzato deve ruotare i dati solo se è impostato il flag ruotare il campo di bit. Anche se il driver determina che l'orientamento corrente dello schermo viene ruotato dai dati della presentazione e Ruota non è impostato, il driver non deve ruotare i dati.
L'impostazione di questo membro equivale all'impostazione del quarto bit del membro Valore a 32 bit (0x00002000).
PresentToBitmap
Valore UINT che specifica se presentare a una bitmap.
L'impostazione di questo membro equivale a impostare il quindicesimo bit del membro Valore a 32 bit (0x00004000).
Supportato a partire da Windows 7.
RedirectedFlip
Valore UINT che specifica se reindirizzare un capovolgimento a una nuova superficie.
L'impostazione di questo membro equivale a impostare il sedicesimo bit del membro Valore a 32 bit (0x00008000).
Supportato a partire da Windows 7.
RedirectedBlt
Valore UINT che specifica se reindirizzare un bitblt a una nuova superficie.
L'impostazione di questo membro equivale a impostare il diciassettesimo bit del membro Valore a 32 bit (0x00010000).
Supportato a partire da Windows 7.
FlipStereo
Specifica se il driver deve scorrere sia a sinistra che a destra immagini di un'allocazione stereo.
Se il membro FlipOnNextVSync della struttura di DXGK_SETVIDPNSOURCEADDRESS_FLAGS è impostato, il driver deve completare l'operazione di capovolgimento all'immagine sinistra nel VSync successivo e quindi completare l'operazione di scorrimento sull'immagine a destra nella VSync seguente.
Se il membro FlipImmediate della struttura DXGK_SETVIDPNSOURCEADDRESS_FLAGS è impostato, il driver deve iniziare immediatamente a eseguire l'analisi dalla nuova allocazione. Ad esempio, se il driver esegue l'analisi di un'immagine corretta, deve avviare la nuova analisi dallo stesso offset relativo nell'immagine corretta della nuova allocazione.
I membri FlipStereo e FlipStereoTemporaryMono non possono essere impostati contemporaneamente.
Per altri requisiti, vedere la sezione Osservazioni.
L'impostazione di questo membro equivale a impostare il diciottesimo bit del membro Valore a 32 bit (0x00020000).
Supportato a partire da Windows 8.
FlipStereoTemporaryMono
Specifica se il driver deve usare l'immagine sinistra di un'allocazione stereo per le parti destra e sinistra di un frame stereo. Il driver esegue la stessa operazione presente di FlipStereo, ad eccezione del fatto che deve essere eseguita solo dall'immagine sinistra per produrre entrambe le immagini di un frame stereo.
Questo membro deve essere impostato solo se il driver segnala il supporto per questa opzione nella modalità di visualizzazione corrente impostando il membro Type della struttura D3DKMDT_VIDPN_SOURCE_MODE su D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN .
I membri FlipStereo e FlipStereoTemporaryMono non possono essere impostati contemporaneamente.
I membri FlipStereoTemporaryMono e FlipStereoPreferRight non possono essere impostati contemporaneamente.
Per altri requisiti, vedere la sezione Osservazioni.
L'impostazione di questo membro equivale a impostare il diciannovesimo bit del membro Valore a 32 bit (0x00040000).
Supportato a partire da Windows 8.
FlipStereoPreferRight
Specifica che quando il driver clona un'allocazione primaria stereo in un monitor mono, deve usare l'immagine corretta.
I membri FlipStereoTemporaryMono e FlipStereoPreferRight non possono essere impostati contemporaneamente.
Per altri requisiti, vedere la sezione Osservazioni.
L'impostazione di questo membro equivale a impostare il ventesimo bit del membro Valore a 32 bit (0x00080000).
Supportato a partire da Windows 8.
BltStereoUseRight
Specifica che quando il driver presenta da un'allocazione stereo a un'allocazione mono, deve usare l'immagine corretta. In caso contrario, il driver deve usare l'immagine sinistra.
L'impostazione di questo membro equivale a impostare il ventesimo bit del membro Value a 32 bit (0x00100000).
Supportato a partire da Windows 8.
PresentHistoryTokenOnly
Specifica che il driver deve inviare solo un token di cronologia presente.
Un token di cronologia presente è un pacchetto di dati che l'app di rendering invia per informare Desktop Window Manager (DWM) che il rendering è completo e il buffer back della catena di scambio è pronto per essere presentato.
L'impostazione di questo membro equivale a impostare il ventiduesimo bit del membro Valore a 32 bit (0x00200000).
Supportato a partire da Windows 8.
PresentRegionsValid
Specifica che il D3DKMT_PRESENT. pPresentRegions membro è un puntatore valido (non NULL).
L'impostazione di questo membro equivale a impostare il ventitreesimo bit del membro Valore a 32 bit (0x00400000).
Supportato a partire da Windows 8.
PresentDDA
Questo membro è riservato e deve essere impostato su zero.
L'impostazione di questo membro equivale a impostare il ventiquattro bit del membro Valore a 32 bit (0x00800000).
Supportato a partire da Windows 8.
ProtectedContentBlankedOut
Questo membro è riservato e deve essere impostato su zero.
L'impostazione di questo membro equivale a impostare il venticinque bit del membro Valore a 32 bit (0x01000000).
Supportato a partire da Windows 8.
RemoteSession
Specifica che l'operazione presente viene indirizzata a una sessione remota.
L'impostazione di questo membro equivale a impostare il ventisei bit del membro Valore a 32 bit (0x02000000).
Supportato a partire da Windows 8.
CrossAdapter
Scheda incrociata.
DurationValid
Indica se la durata è valida.
PresentIndirect
Presente indiretto.
PresentHMD
Reserved
Supportato a partire da Windows 8.
Questo membro è riservato e deve essere impostato su zero. L'impostazione di questo membro su zero equivale all'impostazione dei restanti 9 bit (0xFF800000) del membro Value a 32 bit su zeri.
Value
Valore a 32 bit che identifica come eseguire l'operazione corrente.
Commenti
Se vengono impostati uno dei membri FlipStereo, FlipStereoTemporaryMono o FlipStereoPreferRight , si applicano le condizioni seguenti:
- Il membro hAllocation della struttura DXGKARG_SETVIDPNSOURCEADDRESS deve puntare a un'allocazione creata con il membro Stereo impostato nel membro Flags della struttura D3DKMT_DISPLAYMODE .
- I membri PrimarySegment e PrimaryAddress di DXGKARG_SETVIDPNSOURCEADDRESS devono puntare all'indirizzo fisico iniziale dell'allocazione.
- Il driver deve rispettare le impostazioni dei membri FlipImmediate e FlipOnNextVSync della struttura DXGK_SETVIDPNSOURCEADDRESS_FLAGS .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows Vista. |
| Intestazione | d3dkmthk.h (include D3dkmthk.h) |