DXGK_PRESENTFLAGS struttura (d3dkmddi.h)

Articolo
02/23/2024

La struttura DXGK_PRESENTFLAGS identifica, in flag di campo bit, il tipo di operazione presente da eseguire.

Sintassi

typedef struct _DXGK_PRESENTFLAGS {
  union {
    struct {
      UINT Blt : 1;
      UINT ColorFill : 1;
      UINT Flip : 1;
      UINT FlipWithNoWait : 1;
      UINT SrcColorKey : 1;
      UINT DstColorKey : 1;
      UINT LinearToSrgb : 1;
      UINT Rotate : 1;
      UINT FlipStereo : 1;
      UINT FlipStereoTemporaryMono : 1;
      UINT FlipStereoPreferRight : 1;
      UINT BltStereoUseRight : 1;
      UINT FlipWithMultiPlaneOverlay : 1;
      UINT RedirectedFlip : 1;
#if ...
      UINT Reserved : 18;
#elif
      UINT Reserved : 19;
#else
      UINT Reserved : 24;
#endif
    };
    [in] UINT Value;
  };
} DXGK_PRESENTFLAGS;

Members

[in] Blt

Valore UINT che specifica se un'operazione di copia, anziché un'operazione di capovolgimento, si verifica tra le superfici di origine e di destinazione.

L'impostazione di questo membro equivale a impostare il primo bit del membro Valore a 32 bit (0x00000001).

[in] ColorFill

Valore UINT che specifica se esiste un'origine da cui presentare. Se questo membro è impostato, nessuna origine esiste e il driver deve riempire il rettangolo di destinazione nell'area di destinazione con il colore A8R8G8B8 specificato dal membro Colordella struttura DXGKARG_PRESENT.

L'impostazione di questo membro equivale a impostare il secondo bit del membro Valore a 32 bit (0x00000002).

[in] Flip

Valore UINT che specifica se si verifica un'operazione di capovolgimento tra le superfici indietro e primaria. Se questo membro è impostato, il driver deve eseguire l'operazione presente puntando l'output dell'analisi video all'origine anziché copiando dall'origine alla destinazione. Questo tipo di operazione presente è senza strappo.

L'impostazione di questo membro equivale a impostare il terzo bit del membro Valore a 32 bit (0x00000004).

[in] FlipWithNoWait

Valore UINT che specifica se le operazioni di capovolgimento senza strappo non devono essere bloccate nella pipeline grafica. Se un capovolgimento senza strappo si blocca la pipeline grafica, l'unità di elaborazione grafica (GPU) deve attendere che il capovolgimento senza strappo venga eseguito prima di eseguire il comando successivo.

FlipWithNoWait può essere impostato su TRUE (ovvero, 1) solo se il driver miniport visualizzato imposta il flag di campo FlipOnVSyncWithNoWait nel membro FlipCapsdella struttura DXGK_DRIVERCAPS quando il valore DXGKQAITYPE_DRIVERCAPS è stato specificato nel membro Typedella struttura DXGKARG_QUERYADAPTERINFO in una chiamata alla funzione DxgkDdiQueryAdapterInfo del driver.

L'impostazione di questo membro equivale a impostare il quarto bit del membro Valore a 32 bit (0x00000008).

[in] SrcColorKey

Valore UINT che specifica se eseguire la chiave di colore di origine usando il valore nel membro Color della struttura DXGKARG_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 quinto bit del membro Valore a 32 bit (0x00000010).

[in] DstColorKey

Valore UINT che specifica se eseguire la chiave dei colori di destinazione usando il valore nel membro Color della struttura DXGKARG_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 il sesto bit del membro Valore a 32 bit (0x00000020).

[in] 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, visitare il sito Web sRGB .

L'impostazione di questo membro equivale a impostare il settimo bit del membro Value a 32 bit (0x00000040).

[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 a impostare l'ottavo bit del membro Valore a 32 bit (0x00000080).

[in] 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 nono bit del membro Valore a 32 bit (0x00000100).

Supportato a partire da Windows 8.

[in] 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 decimo bit del membro Valore a 32 bit (0x00000200).

Supportato a partire da Windows 8.

[in] 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 l'undicesimo bit del membro Valore a 32 bit (0x00000400).

Supportato a partire da Windows 8.

[in] 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 dodicesimo bit del membro Valore a 32 bit (0x00000800).

Supportato a partire da Windows 8.

[in] FlipWithMultiPlaneOverlay

Specifica se si verifica un'operazione di scorrimento tra un piano di sovrapposizione e la superficie primaria. Se questo membro è impostato, il driver deve eseguire l'operazione presente puntando l'output dell'analisi video al piano di origine anziché copiando dal piano di origine alla destinazione.

L'impostazione di questo membro equivale a impostare il tredicesimo bit del membro Valore a 32 bit (0x00001000).

Supportato a partire da Windows 8.1.

RedirectedFlip

[in] Reserved

Questo membro è riservato e deve essere impostato su zero.

L'impostazione di questo membro su zero equivale a impostare i restanti 19 bit (0xFFFFE000) del membro Valore a 32 bit su zero.

Supportato a partire da Windows 8.

[in] Questo membro è riservato e deve essere impostato su zero.

L'impostazione di questo membro su zero equivale a impostare i restanti 24 bit (0xFFFFFF00) del membro Valore a 32 bit su zero.

[in] Value

Membro dell'unione che DXGK_PRESENTFLAGS contiene che può contenere un valore a 32 bit che identifica il tipo di operazione presente da eseguire.

Commenti

I flag di campo a bit ColorFill, SrcColorKey e DstColorKey si escludono a vicenda.

Se vengono impostati uno dei membri FlipStereo, FlipStereoTemporaryMono o FlipStereoPreferRight, queste condizioni si applicano:

Il membro hAllocation della struttura DXGKARG_SETVIDPNSOURCEADDRESS deve puntare a un'allocazione creata con il membro Stereo impostato nel membro Flagdella 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 .