Метод IWICFormatConverterInfo::GetPixelFormats (wincodec.h)

Извлекает список идентификаторов GUID, которые означают, какие форматы пикселей поддерживает преобразователь.

Синтаксис

HRESULT GetPixelFormats(
  [in]      UINT               cFormats,
  [in, out] WICPixelFormatGUID *pPixelFormatGUIDs,
  [out]     UINT               *pcActual
);

Параметры

[in] cFormats

Тип: UINT

Размер массива pPixelFormatGUIDs .

[in, out] pPixelFormatGUIDs

Тип: WICPixelFormatGUID*

Указатель на массив GUID, который получает форматы пикселей, поддерживаемые преобразователем.

[out] pcActual

Тип: UINT*

Фактический размер массива, необходимый для получения всех форматов пикселей, поддерживаемых преобразователем.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Преобразователь формата не обязательно гарантирует симметричность по отношению к преобразованию; т. е. преобразователь может выполнять преобразование ИЗ определенного формата без возможности преобразования в определенный формат. Чтобы проверить симметричность, используйте CanConvert.

Чтобы определить количество форматов пикселей, которые может обрабатывать преобразователь, задайте для параметра cFormats значение 0 , а для pPixelFormatGUID — значение NULL. Преобразователь заполнит pcActual количеством форматов, поддерживаемых этим преобразователем.

Требования