IKsVideoProcessing::GetMatchingOutputMediaType method

A plug-in's implementation of IKsVideoProcessing::GetMatchingOutputMediaType should return the closest matching output media type that the plug-in supports.

Syntax

HRESULT GetMatchingOutputMediaType(
  PKSDATAFORMAT pMediaType,
  PKSDATAFORMAT *ppMatchingMediaType
);

Parameters

  • pMediaType
    A pointer to a KSDATAFORMAT structure that specifies the partial media type that is provided by the caller.

  • ppMatchingMediaType
    A pointer to a buffer that contains a pointer to a KSDATAFORMAT structure. This structure specifies the matching media type that is returned by the plug-in. For more information about this parameter, see the following Remarks section.

Return value

This method returns one of the following values:

Return code Description
S_OK

Plug-in successfully returns a matching output media type.

E_OUTOFMEMORY

The buffer provided in pppMediaTypeList was not large enough to return the requested results.

E_FAIL

Failed to return a matching output media type.

 

Remarks

The plug-in is responsible for allocating the buffer that is pointed to by the ppMatchingMediaType parameter. The plug-in should allocate this memory by using the CoTaskMemAlloc function, but it is not responsible for freeing this memory.

IKsVideoProcessing is defined in Ksvidprocplugin.h. The contents of this header file are provided in Providing a Video Post-Processing Plug-in.

This method is a pure virtual method that is implemented by the vendor-supplied plug-in.

 

 

Send comments about this topic to Microsoft

Build date: 1/23/2012