structure IDDCX_FRAME_STATISTICS (iddcx.h)

Article
08/07/2023

La structure IDDCX_FRAME_STATISTICS fournit des informations sur l’image en cours de traitement.

Syntaxe

struct IDDCX_FRAME_STATISTICS {
  UINT                         Size;
  UINT                         PresentationFrameNumber;
  IDDCX_FRAME_STATUS           FrameStatus;
  UINT                         ReEncodeNumber;
  UINT                         FrameSliceTotal;
  UINT                         CurrentSlice;
  UINT64                       FrameAcquireQpcTime;
  UINT                         FrameProcessingStepsCount;
  IDDCX_FRAME_STATISTICS_STEP  *pFrameProcessingStep;
  UINT64                       SendStartQpcTime;
  UINT64                       SendStopQpcTime;
  UINT64                       SendCompleteQpcTime;
  IDDCX_FRAME_STATISTICS_FLAGS Flags;
  UINT                         ProcessedPixelCount;
  UINT                         FrameSizeInBytes;
};

Membres

Size

Taille totale de cette structure, en octets.

PresentationFrameNumber

Numéro de trame fourni dans un appel précédent à IddCxSwapChainReleaseAndAcquireBuffer (ou IddCxSwapChainReleaseAndAcquireSystemBuffer).

FrameStatus

Valeur IDDCX_FRAME_STATUS qui indique la status globale du traitement de ce frame.

ReEncodeNumber

Nombre de base zéro pour indiquer le nombre de fois où la même image a été encodée et envoyée. Les réencodes peuvent être le résultat du système d’exploitation qui fournit le même frame et le même numéro d’image au pilote à encoder ou le pilote qui doit réencoder en dehors de la présentation du système d’exploitation normale pour satisfaire au protocole.

FrameSliceTotal

Nombre de tranches dans laquelle le pilote traite le cadre. Si les tranches ne sont pas utilisées, cela doit être défini sur la valeur 1.

CurrentSlice

Numéro de tranche de base zéro signalé. Si la découpe n’est pas prise en charge, le pilote doit toujours définir cette valeur sur zéro.

FrameAcquireQpcTime

Heure QPC du système à laquelle le pilote a acquis la mémoire tampon du système d’exploitation.

FrameProcessingStepsCount

Taille du tableau d’étapes d’image pointé vers pFrameProcessingStep.

pFrameProcessingStep

Tableau de structures IDDCX_FRAME_STATISTICS_STEP qui décrivent les étapes de traitement des images effectuées par le pilote.

SendStartQpcTime

Marque l’heure à laquelle le pilote a démarré la transmission de cette tranche à l’appareil. SendStartQpcTime marque l’heure à laquelle le pilote a commencé à appeler les API de transmission, et non le moment où les données commencent réellement à être transmises.

SendStopQpcTime

Marque l’heure à laquelle le pilote a arrêté la transmission de cette tranche à l’appareil. SendStopQpcTime marque l’heure à laquelle le pilote a cessé d’appeler les API de transmission, et non lorsque les données cessent d’être transmises.

SendCompleteQpcTime

Marque l’heure à laquelle l’envoi a été signalé comme terminé par le système d’exploitation. Il s’agit d’un horodatage facultatif qui peut être utilisé si le pilote utilise une API de transmission asynchrone et une routine d’achèvement. Si le pilote n’a pas de routine d’achèvement asynchrone, cette valeur doit être définie sur zéro.

Flags

Valeur IDDCX_FRAME_STATISTICS_FLAGS qui indique comment le cadre a été modifié par le pilote.

ProcessedPixelCount

Nombre total de pixels traités dans ce cadre.

FrameSizeInBytes

Taille totale des données envoyées à l’appareil pour ce cadre. Cette valeur inclut toutes les tranches.