structure DXGI_OUTDUPL_FRAME_INFO (dxgi1_2.h)

  • Article

La structure DXGI_OUTDUPL_FRAME_INFO décrit l’image de bureau actuelle.

Syntaxe

typedef struct DXGI_OUTDUPL_FRAME_INFO {
  LARGE_INTEGER                 LastPresentTime;
  LARGE_INTEGER                 LastMouseUpdateTime;
  UINT                          AccumulatedFrames;
  BOOL                          RectsCoalesced;
  BOOL                          ProtectedContentMaskedOut;
  DXGI_OUTDUPL_POINTER_POSITION PointerPosition;
  UINT                          TotalMetadataBufferSize;
  UINT                          PointerShapeBufferSize;
} DXGI_OUTDUPL_FRAME_INFO;

Membres

LastPresentTime

Horodatage de la dernière mise à jour de l’image de bureau. Le système d’exploitation appelle la fonction QueryPerformanceCounter pour obtenir la valeur. Une valeur zéro indique que l’image de bureau n’a pas été mise à jour depuis qu’une application a appelé la dernière méthode IDXGIOutputDuplication::AcquireNextFrame pour acquérir l’image suivante de l’image de bureau.

LastMouseUpdateTime

Horodatage de la dernière mise à jour de la souris. Le système d’exploitation appelle la fonction QueryPerformanceCounter pour obtenir la valeur. Une valeur zéro indique que la position ou la forme de la souris n’a pas été mise à jour depuis qu’une dernière application a appelé la méthode IDXGIOutputDuplication::AcquireNextFrame pour acquérir le cadre suivant de l’image de bureau. La position de la souris est toujours fournie pour une mise à jour de la souris. Une nouvelle forme de pointeur est indiquée par une valeur différente de zéro dans le membre PointerShapeBufferSize .

AccumulatedFrames

Nombre d’images que le système d’exploitation a accumulées dans l’image de bureau surface depuis que l’application appelante a traité la dernière image de bureau. Pour plus d’informations sur ce nombre, consultez Remarques.

RectsCoalesced

Spécifie si le système d’exploitation a accumulé les mises à jour en fusionnant sale régions. Par conséquent, les régions sale peuvent contenir des pixels non modifiés. TRUE si sale régions ont été accumulées ; sinon, FALSE.

ProtectedContentMaskedOut

Spécifie si l’image de bureau peut contenir du contenu protégé qui a déjà été noirci dans l’image de bureau. TRUE si le contenu protégé était déjà noirci ; sinon, FALSE. L’application peut utiliser ces informations pour informer l’utilisateur distant qu’une partie du contenu du bureau peut être protégée et donc non visible.

PointerPosition

Une structure DXGI_OUTDUPL_POINTER_POSITION qui décrit la position de la souris la plus récente si le membre LastMouseUpdateTime est une valeur différente de zéro ; sinon, cette valeur est ignorée. Cette valeur fournit les coordonnées de l’emplacement où le coin supérieur gauche de la forme pointeur est dessiné ; cette valeur n’est pas la position de bureau du point chaud.

TotalMetadataBufferSize

Taille en octets des mémoires tampons pour stocker toutes les métadonnées de mise à jour du bureau pour ce cadre. Pour plus d’informations sur cette taille, consultez Remarques.

PointerShapeBufferSize

Taille en octets de la mémoire tampon pour contenir les nouvelles données de pixel pour la forme de la souris. Pour plus d’informations sur cette taille, consultez Remarques.

Notes

Un LastMouseUpdateTime non nul indique une mise à jour de la position du pointeur de la souris ou de la position et de la forme du pointeur de la souris. Autrement dit, la position du pointeur de la souris est toujours valide pour un LastMouseUpdateTime non nul ; toutefois, l’application doit case activée la valeur du membre PointerShapeBufferSize pour déterminer si la forme a également été mise à jour.

Si seul le pointeur a été mis à jour (autrement dit, l’image de bureau n’a pas été mise à jour), les membres AccumulatedFrames, TotalMetadataBufferSize et LastPresentTime sont définis sur zéro.

Une valeur AccumulatedFrames de un indique que l’application a terminé le traitement de la dernière image avant qu’une nouvelle image de bureau ne soit présentée. Si la valeur AccumulatedFrames est supérieure à une, plusieurs mises à jour d’image de bureau se sont produites pendant que l’application a traité la dernière mise à jour du bureau. Dans ce cas, le système d’exploitation a accumulé les régions de mise à jour. Pour plus d’informations sur les mises à jour du bureau, consultez Données de mise à jour du bureau.

Un TotalMetadataBufferSize non nul indique la taille totale des mémoires tampons requises pour stocker toutes les métadonnées de mise à jour du bureau. Une application ne peut pas déterminer la taille de chaque type de métadonnées. L’application doit appeler la méthode IDXGIOutputDuplication::GetFrameDirtyRects, IDXGIOutputDuplication::GetFrameMoveRects ou IDXGIOutputDuplication::GetFramePointerShape pour obtenir des informations sur chaque type de métadonnées.

Note Pour corriger les effets visuels, une application doit traiter les données de la région de déplacement avant de traiter les rectangles sale.
 

Spécifications

   
Client minimal pris en charge Windows 8 et Mise à jour de la plateforme pour Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau uniquement]
En-tête dxgi1_2.h

Voir aussi

DXGI Structures

IDXGIOutputDuplication::AcquireNextFrame