Microsoft DirectX 8.0

IDirectDrawMediaSampleAllocator Interface

The IDirectDrawMediaSampleAllocator interface is implemented on the allocator created by the Overlay Mixer for its upstream connection with a video decoder. This allocator allocates IDirectDrawMediaSample media samples that also support the IMediaSample interface.

Decoder filters should not have to use this interface to connect to the Overlay Mixer. Applications never use this interface.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IDirectDrawMediaSampleAllocator methodsDescription
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.