struttura D3DKMT_PRESENT (d3dkmthk.h)
La struttura D3DKMT_PRESENT descrive l'operazione corrente.
Sintassi
typedef struct _D3DKMT_PRESENT {
union {
[in] D3DKMT_HANDLE hDevice;
[in] D3DKMT_HANDLE hContext;
};
[in] HWND hWindow;
[in] D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
[in] D3DKMT_HANDLE hSource;
[in] D3DKMT_HANDLE hDestination;
[in] UINT Color;
[in] RECT DstRect;
[in] RECT SrcRect;
[in] UINT SubRectCnt;
[in] const RECT *pSrcSubRects;
[in] UINT PresentCount;
[in] D3DDDI_FLIPINTERVAL_TYPE FlipInterval;
[in] D3DKMT_PRESENTFLAGS Flags;
[in] ULONG BroadcastContextCount;
D3DKMT_HANDLE BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
[in] HANDLE PresentLimitSemaphore;
[in] D3DKMT_PRESENTHISTORYTOKEN PresentHistoryToken;
D3DKMT_PRESENT_RGNS *pPresentRegions;
union {
D3DKMT_HANDLE hAdapter;
D3DKMT_HANDLE hIndirectContext;
};
UINT Duration;
D3DKMT_HANDLE *BroadcastSrcAllocation;
D3DKMT_HANDLE *BroadcastDstAllocation;
UINT PrivateDriverDataSize;
PVOID pPrivateDriverData;
BOOLEAN bOptimizeForComposition;
} D3DKMT_PRESENT;
Membri
[in] hDevice
Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel al dispositivo a cui presentare. Un handle di dispositivo viene fornito alla funzione D3DKMTPresent
[in] hContext
Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per il contesto di dispositivo a cui presentare.
[in] hWindow
Handle per la finestra a cui si applica il trasferimento bit-block (bitblt). Il valore null indica la finestra desktop. Il valore in
[in] VidPnSourceId
Il numero di identificazione in base zero dell'origine video presente in un percorso di una topologia di rete (VidPN) video su cui limitare la visualizzazione, se il flag RestrictVidPnSource campo di bit viene impostato nel membro Flag.
Se viene impostato il flag
[in] hSource
Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per la memoria di sistema o l'allocazione primaria da presentare, se il flag
[in] hDestination
Tipo di dati D3DKMT_HANDLE che rappresenta un handle in modalità kernel per l'allocazione di destinazione. hDestination può essere zero se la destinazione è sconosciuta.
L'handle in
Se l'handle nel membro
[in] Color
Valore arGB a 32 bit (vedere l'enumerazione D3DDDIFORMAT) o il valore della chiave di colore . Un valore per il riempimento del colore viene impostato quando il flag di
Se il formato primario è pallido RGB, Color contiene l'indice della tavolozza anziché il valore D3DDDIFMT_A8R8G8B8 da D3DDDIFORMAT.
[in] DstRect
La destinazione facoltativa RECT per bitblt. La proprietà RECT di destinazione viene utilizzata solo se il
[in] SrcRect
RECT di origine facoltativo per bitblt. L'oggetto RECT di origine viene usato solo se il
[in] SubRectCnt
Numero di aree subrectangulari che pSrcSubRects puntano a che vengono specificate durante la presentazione.
[in] pSrcSubRects
Puntatore a una matrice di aree subrectangulari (RECT) specificate durante la presentazione.
[in] PresentCount
Numero di operazioni presenti che possono essere accodate per il dispositivo specificato da hDevice.
[in] FlipInterval
Valore D3DDDI_FLIPINTERVAL_TYPE-typed che indica l'intervallo di capovolgimento, ovvero se lo scorrimento si verifica dopo zero, uno, due, tre o quattro sincronizzazioni verticali.
[in] Flags
Struttura D3DKMT_PRESENTFLAGS che identifica, in flag di campo di bit, come visualizzare. Si noti che i ColorFill, SrcColorKeye flag DstColorKey bit-field si escludono a vicenda.
[in] BroadcastContextCount
Numero di contesti aggiuntivi nella matrice specificata BroadcastContext.
[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]
Matrice di D3DKMT_HANDLE tipi di dati che rappresentano handle in modalità kernel nei contesti aggiuntivi a cui trasmettere l'operazione corrente. La costante D3DDDI_MAX_BROADCAST_CONTEXT, definita come 64, definisce il numero massimo di contesti a cui la progettazione immagine e configurazione OpenGL può trasmettere l'operazione corrente.
La trasmissione è supportata solo per le operazioni di scorrimento. Per trasmettere un'operazione di scorrimento, il driver miniport di visualizzazione deve supportare i capovolgimenti basati su I/O mappati alla memoria (MMIO). Per indicare il supporto dei capovolgimenti MMIO, il driver miniport di visualizzazione imposta il flag FlipOnVSyncMmIo flag di campo di bit nel FlipCaps membro della struttura DXGK_DRIVERCAPS quando viene chiamata la funzione DxgkDdiQueryAdapterInfo.
Il contesto originale a cui il membro hContext
[in] PresentLimitSemaphore
Handle per il semaforo presente limite.
Supportato a partire da Windows 7.
[in] PresentHistoryToken
Struttura D3DKMT_PRESENTHISTORYTOKEN che identifica il tipo di operazione presente.
Supportato a partire da Windows 7.
pPresentRegions
Puntatore a una struttura D3DKMT_PRESENT_RGNS che identifica le aree dirty e move.
Supportato a partire da Windows 8.
hAdapter
Handle per la scheda grafica.
hIndirectContext
Contesto dell'adattatore indiretto per il reindirizzamento tramite il percorso corrente doD. Questo membro è valido solo se è impostato il flag PresentIndirect.
Duration
Durata per presente. Valido solo quando è impostato il flag DurationValid.
BroadcastSrcAllocation
Adattatore di visualizzazione collegato per l'origine.
BroadcastDstAllocation
Adattatore di visualizzazione collegato per la destinazione.
PrivateDriverDataSize
Dimensioni dei dati del driver privato.
pPrivateDriverData
Puntatore a un buffer che contiene dati facoltativi del driver privato.
bOptimizeForComposition
Indica se il dispositivo è ottimizzato per la composizione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| intestazione |
d3dkmthk.h (include D3dkmthk.h) |