estructura IDDCX_FRAME_STATISTICS (iddcx.h)

Artículo
08/07/2023

La estructura IDDCX_FRAME_STATISTICS proporciona información sobre el marco actual que se está procesando.

Sintaxis

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

Miembros

Size

Tamaño total de esta estructura, en bytes.

PresentationFrameNumber

Número de fotograma proporcionado en una llamada anterior a IddCxSwapChainReleaseAndAcquireBuffer (o IddCxSwapChainReleaseAndAcquireSystemBuffer).

FrameStatus

Valor de IDDCX_FRAME_STATUS que indica el estado general del procesamiento de este marco.

ReEncodeNumber

Número de base cero para indicar el número de veces que se ha codificado y enviado el mismo marco. Las recodificación pueden ser el resultado del sistema operativo que proporciona el mismo número de fotograma y fotograma al controlador para codificar o el controlador que tiene que volver a codificar fuera de la presentación normal del sistema operativo para satisfacer el protocolo.

FrameSliceTotal

Número de segmentos en los que el controlador procesa el marco. Si no se usan segmentos, se debe establecer en el valor uno.

CurrentSlice

Número de segmento de base cero que se notifica. Si no se admite la segmentación, el controlador siempre debe establecerlo en el valor cero.

FrameAcquireQpcTime

QPC del sistema en el que el controlador adquirió el búfer del sistema operativo.

FrameProcessingStepsCount

Tamaño de la matriz de pasos de marco a la que apunta pFrameProcessingStep.

pFrameProcessingStep

Matriz de estructuras de IDDCX_FRAME_STATISTICS_STEP que describen los pasos de procesamiento de fotogramas que realizó el controlador.

SendStartQpcTime

Marca la hora en que el controlador inició la transmisión de este segmento al dispositivo. SendStartQpcTime marca la hora en que el controlador comenzó a llamar a las API de transmisión, no cuando los datos comienzan a transmitirse realmente.

SendStopQpcTime

Marca la hora en que el controlador detuvo la transmisión de este segmento al dispositivo. SendStopQpcTime marca la hora en que el controlador dejó de llamar a las API de transmisión, no cuando los datos realmente dejan de transmitirse.

SendCompleteQpcTime

Marca la hora en que el sistema operativo notificó el envío como completado. Se trata de una marca de tiempo opcional que se puede usar si el controlador usa una API de transmisión asincrónica y una rutina de finalización. En caso de que el controlador no tenga una rutina de finalización asincrónica, este valor debe establecerse en cero.

Flags

Valor de IDDCX_FRAME_STATISTICS_FLAGS que indica cómo el controlador modificó el marco.

ProcessedPixelCount

Número total de píxeles procesados en este marco.

FrameSizeInBytes

Tamaño total de los datos enviados al dispositivo para esta trama. Este valor incluye todos los segmentos.