IMFByteStreamHandler::CancelObjectCreation method (mfidl.h)

Cancels the current request to create a media source.

Syntax

HRESULT CancelObjectCreation(
  [in] IUnknown *pIUnknownCancelCookie
);

Parameters

[in] pIUnknownCancelCookie

Pointer to the IUnknown interface that was returned in the ppIUnknownCancelCookie parameter of the IMFByteStreamHandler::BeginCreateObject method.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

You can use this method to cancel a previous call to BeginCreateObject. Because that method is asynchronous, however, it might be completed before the operation can be canceled. Therefore, your callback might still be invoked after you call this method.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFByteStreamHandler

Scheme Handlers and Byte-Stream Handlers