структура DXGI_OUTDUPL_FRAME_INFO (dxgi1_2.h)

Структура DXGI_OUTDUPL_FRAME_INFO описывает текущий образ рабочего стола.

Синтаксис

typedef struct DXGI_OUTDUPL_FRAME_INFO {
  LARGE_INTEGER                 LastPresentTime;
  LARGE_INTEGER                 LastMouseUpdateTime;
  UINT                          AccumulatedFrames;
  BOOL                          RectsCoalesced;
  BOOL                          ProtectedContentMaskedOut;
  DXGI_OUTDUPL_POINTER_POSITION PointerPosition;
  UINT                          TotalMetadataBufferSize;
  UINT                          PointerShapeBufferSize;
} DXGI_OUTDUPL_FRAME_INFO;

Члены

LastPresentTime

Метка времени последнего обновления образа рабочего стола. Операционная система вызывает функцию QueryPerformanceCounter для получения значения . Нулевое значение указывает, что образ рабочего стола не обновлялся с тех пор, как приложение в последний раз вызывало метод IDXGIOutputDuplication::AcquireNextFrame для получения следующего кадра образа рабочего стола.

LastMouseUpdateTime

Метка времени последнего обновления мыши. Операционная система вызывает функцию QueryPerformanceCounter для получения значения . Нулевое значение указывает, что положение или форма мыши не обновлялись с тех пор, как приложение в последний раз вызывало метод IDXGIOutputDuplication::AcquireNextFrame для получения следующего кадра изображения рабочего стола. Положение мыши всегда предоставляется для обновления мыши. Новая фигура указателя обозначается ненулевым значением в элементе PointerShapeBufferSize .

AccumulatedFrames

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

RectsCoalesced

Указывает, накапливала ли операционная система обновления путем объединения грязное регионов. Таким образом, грязное области могут содержать неизмененные пиксели. ЗНАЧЕНИЕ TRUE, если грязное регионов были накоплены; в противном случае — ЗНАЧЕНИЕ FALSE.

ProtectedContentMaskedOut

Указывает, может ли образ рабочего стола содержать защищенное содержимое, которое уже было затемнено в образе рабочего стола. ЗНАЧЕНИЕ TRUE , если защищенное содержимое уже зачернено; в противном случае — FALSE. Приложение может использовать эти сведения, чтобы уведомить удаленного пользователя о том, что часть содержимого рабочего стола может быть защищена и, следовательно, невидима.

PointerPosition

Структура DXGI_OUTDUPL_POINTER_POSITION, описывающая последнюю позицию мыши, если элемент LastMouseUpdateTime является ненулевым значением; В противном случае это значение игнорируется. Это значение предоставляет координаты расположения, где рисуется левый верхний угол фигуры указателя; Это значение не является положением рабочего стола горячей точки.

TotalMetadataBufferSize

Размер буферов в байтах для хранения всех метаданных обновления рабочего стола для этого кадра. Дополнительные сведения об этом размере см. в разделе Примечания.

PointerShapeBufferSize

Размер буфера в байтах для хранения новых данных пикселей для фигуры мыши. Дополнительные сведения об этом размере см. в разделе Примечания.

Комментарии

Ненулевое значение LastMouseUpdateTime указывает на изменение положения указателя мыши или положения и фигуры указателя мыши. То есть положение указателя мыши всегда допустимо для ненулевого значения LastMouseUpdateTime; однако приложение должно проверка значение элемента PointerShapeBufferSize, чтобы определить, была ли обновлена фигура.

Если был обновлен только указатель (т. е. образ рабочего стола не был обновлен), элементы AccumulatedFrames, TotalMetadataBufferSize и LastPresentTime будут равны нулю.

Значение Накопленные кадры , равное одному, указывает, что приложение завершило обработку последнего кадра перед представлением нового изображения рабочего стола. Если значение Накопленные кадры больше единицы, в то время как приложение обработало последнее обновление рабочего стола, произошло несколько обновлений образа рабочего стола. В этом случае операционная система накопила регионы обновления. Дополнительные сведения об обновлениях рабочего стола см. в разделе Данные обновления рабочего стола.

Ненулевое значение TotalMetadataBufferSize указывает общий размер буферов, необходимых для хранения всех метаданных обновления рабочего стола. Приложение не может определить размер каждого типа метаданных. Чтобы получить сведения о каждом типе метаданных, приложение должно вызвать метод IDXGIOutputDuplication::GetFrameDirtyRects, IDXGIOutputDuplication::GetFrameMoveRects или IDXGIOutputDuplication::GetFramePointerShape .

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

Требования

   
Минимальная версия клиента Windows 8 и Обновление платформы для Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2012 и Обновление платформы для Windows Server 2008 R2 [только классические приложения]
Верхняя часть dxgi1_2.h

См. также раздел

Структуры DXGI

IDXGIOutputDuplication::AcquireNextFrame