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