IResourceManager::CancelRequest

 
Microsoft DirectShow 9.0

IResourceManager::CancelRequest

The CancelRequest method cancels the request for a resource.

Syntax

  HRESULT CancelRequest(
  LONG idResource,
  IResourceConsumer *pConsumer
);

Parameters

idResource

[in] Resource identifier of a pending request.

pConsumer

[in] Pointer to the IResourceConsumer interface that made the request.

Return Value

Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.

Return code Description
E_FAIL Failure.
E_POINTER Null pointer argument.
E_INVALIDARG Invalid argument.
E_NOTIMPL Method isn't supported.
S_OK or NOERROR Success.

Remarks

This method should be called when the IResourceConsumer object that requested the resource has not received it and no longer requires it. If it has already received the resource, it should use the IResourceManager::NotifyRelease method.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also