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

Статья
08/07/2023

Структура 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

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

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

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