Метод IDirectXVideoDecoder::GetCreationParameters (dxva2api.h)

  • Статья

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

Синтаксис

HRESULT GetCreationParameters(
  [out] GUID                      *pDeviceGuid,
  [out] DXVA2_VideoDesc           *pVideoDesc,
  [out] DXVA2_ConfigPictureDecode *pConfig,
  [out] IDirect3DSurface9         ***pDecoderRenderTargets,
  [out] UINT                      *pNumSurfaces
);

Параметры

[out] pDeviceGuid

Получает GUID устройства. Этот параметр может принимать значение NULL.

[out] pVideoDesc

Указатель на структуру DXVA2_VideoDesc , получающую описание формата видео. Этот параметр может принимать значение NULL.

[out] pConfig

Указатель на структуру DXVA2_ConfigPictureDecode , которая получает конфигурацию декодера. Этот параметр может принимать значение NULL.

[out] pDecoderRenderTargets

Получает массив указателей интерфейса IDirect3DSurface9 . Эти указатели представляют целевые объекты отрисовки декодера. Метод выделяет память для массива и вызывает Метод AddRef для каждого указателя. Вызывающий объект должен освободить указатели и вызвать CoTaskMemFree , чтобы освободить память для массива. Этот параметр может принимать значение NULL.

[out] pNumSurfaces

Получает количество элементов в массиве pppDecoderRenderTargets . Этот параметр может принимать значение NULL.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 Недопустимый аргумент. По крайней мере один параметр должен иметь значение, отличное от NULL.

Комментарии

Если результат не требуется, для любого параметра можно задать значение NULL . По крайней мере один параметр должен иметь значение, отличное от NULL.

Если указать значение, отличное от NULL , для pppDecoderRenderTargets (для получения целевых поверхностей отрисовки), pNumSurfaces не может иметь значение NULL, так как он получает размер массива, возвращаемого в pppDecoderRenderTargets.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header dxva2api.h

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

DirectX Video Acceleration 2.0

IDirectXVideoDecoder