structure IDDCX_FRAME_STATISTICS (iddcx.h)

2025-02-07

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 frame fourni dans un appel précédent à IddCxSwapChainReleaseAndAcquireBuffer (ou IddCxSwapChainReleaseAndAcquireSystemBuffer).

FrameStatus

Valeur IDDCX_FRAME_STATUS qui indique l’état global du traitement de cette trame.

ReEncodeNumber

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

FrameSliceTotal

Nombre de tranches dans laquelle le pilote traite le frame. 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 le découpage n’est pas pris en charge, le pilote doit toujours définir cette valeur sur zéro.

FrameAcquireQpcTime

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

FrameProcessingStepsCount

Taille du tableau d’étapes de trame pointée par pFrameProcessingStep.

pFrameProcessingStep

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

SendStartQpcTime

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

SendStopQpcTime

Marque l’heure à laquelle le pilote a arrêté la transmission de cette tranche vers l’appareil. SendStopQpcTime marque le moment où le pilote a cessé d’appeler les API de transmission, et non lorsque les données s’arrêtent réellement 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 l’image a été modifiée par le pilote.

ProcessedPixelCount

Nombre total de pixels traités dans ce cadre.

FrameSizeInBytes

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