Share via

ISurfaceManager::get_IdealVideoSize

  • Article

The get_IdealVideoSize method retrieves the ideal video size for the surface.

Syntax

HRESULT get_IdealVideoSize(
  VIDEO_SIZE*  pSize
);

Parameters

pSize

[out]  Pointer to a VIDEO_SIZE structure that specifies the ideal video size for the surface in this device.

Return Values

The method returns an HRESULT of S_OK for success, or a standard COM error code for failure.

Remarks

This method is used to determine non-square pixel aspect ratios when rendering to a 16:9 screen. The returned value is compared to the actual output buffer size to determine the ratio.

You can call this method to determine what size to allocate for a new surface before calling AllocSurfaceSize.

Requirements

Client: Windows Vista

Header: Include gputransformplugin.h and GPUPipelineTime.h.

Library: Use GPUPipelineVC7.lib (for Visual Studio .NET) or GPUPipelineVC8.lib (for Visual Studio 2005).

See Also