IDirectDrawStreamSample::GetSurface
Microsoft DirectShow 9.0 |
IDirectDrawStreamSample::GetSurface
- Note This interface is deprecated. New applications should not use it.
Retrieves pointers to the current sample's DirectDraw surface and associated clipping rectangle.
Syntax
HRESULT GetSurface( IDirectDrawSurface **ppDirectDrawSurface, RECT *pRect );
Parameters
ppDirectDrawSurface
[out] Address of a pointer to an IDirectDrawSurface interface that specifies the sample's new surface. Set this parameter to NULL if you don't want to specify a new surface.
pRect
[out] Pointer to a RECT structure that will contain the current sample's clipping rectangle. Set this parameter to NULL if you don't want to retrieve the clipping rectangle.
Return Values
Returns an HRESULT value.
Remarks
Both parameters are optional. All implementations of this interface must support null values as valid parameters. If you retrieve a surface pointer, this method increments its reference count, so you must release the reference.
See Also