IDirectDrawMediaSampleAllocator Interface

The IDirectDrawMediaSampleAllocator interface retrieves a pointer to the Microsoft® DirectDraw® instance. This interface enables objects that also support IMemAllocator to allocate DirectDraw surfaces as media samples.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IDirectDrawMediaSampleAllocator methods Description

GetDirectDraw Retrieves the DirectDraw instance used to allocate surfaces.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IDirectDrawMediaSampleAllocator methods	Description
GetDirectDraw	Retrieves the DirectDraw instance used to allocate surfaces.

IDirectDrawMediaSampleAllocator::GetDirectDraw

IDirectDrawMediaSampleAllocator Interface

Retrieves a pointer to the DirectDraw instance used to allocate surfaces.

Syntax

HRESULT GetDirectDraw(
    IDirectDraw **ppDirectDraw
);

Parameters

ppDirectDraw
[out] Address of a pointer that receives the DirectDraw object's IDirectDraw interface.

Return Value

Returns an HRESULT value.

Remarks

The caller should release the returned IDirectDraw pointer, except when calling the Overlay Mixer filter's implementation of this interface.