структура IDDCX_FRAME_STATISTICS (iddcx.h)

2025-02-07

Структура IDDCX_FRAME_STATISTICS предоставляет сведения о обрабатываемом текущем кадре.

Синтаксис

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;
};

Члены

Size

Общий размер этой структуры в байтах.

PresentationFrameNumber

Номер кадра, предоставленный перед вызовом IddCxSwapChainReleaseAndAcquireBuffer (или IddCxSwapChainReleaseAndAcquireSystemBuffer).

FrameStatus

Значение IDDCX_FRAME_STATUS, указывающее общее состояние обработки этого кадра.

ReEncodeNumber

Отсчитываемый от нуля номер, указывающий количество раз, когда один и тот же кадр был закодирован и отправлен. Повторное кодирование может быть результатом операционной системы, предоставляющей тот же номер кадра и кадра драйверу для кодирования или драйвера, который должен повторно кодировать вне обычной презентации ОС для удовлетворения протокола.

FrameSliceTotal

Количество срезов, в которых драйвер обрабатывает кадр. Если срезы не используются, оно должно быть задано в качестве значения.

CurrentSlice

Отсчитываемый от нуля номер среза. Если срезы не поддерживаются, драйвер всегда должен задать это значение нулю.

FrameAcquireQpcTime

Системное время QPC, при котором драйвер приобрел буфер из ОС.

FrameProcessingStepsCount

Размер массива шагов кадра, на который указывает pFrameProcessingStep.

pFrameProcessingStep

Массив IDDCX_FRAME_STATISTICS_STEP структур, описывающих шаги обработки кадров, выполняемые драйвером.

SendStartQpcTime

Помечает время начала передачи драйвера для этого среза на устройство. SendStartQpcTime помечает время, когда драйвер начал вызывать API передачи, а не когда данные на самом деле начинают передаваться.

SendStopQpcTime

Помечает время остановки передачи драйвера для этого среза на устройство. SendStopQpcTime помечает время, когда драйвер перестал вызывать API передачи, а не когда данные фактически перестают передаваться.

SendCompleteQpcTime

Помечает время завершения отправки операционной системой. Это необязательная метка времени, которую можно использовать, если драйвер использует асинхронный API передачи и подпрограмму завершения. В случае, если драйвер не имеет асинхронной процедуры завершения, это значение должно быть равно нулю.

Flags

Значение IDDCX_FRAME_STATISTICS_FLAGS, указывающее, как кадр был изменен драйвером.

ProcessedPixelCount

Общее количество пикселей, обработанных в этом кадре.

FrameSizeInBytes

Общий размер данных, отправленных на устройство для этого кадра. Это значение включает все срезы.