CBaseAllocator::CBaseAllocator

  • Article
 
Microsoft DirectShow 9.0

CBaseAllocator::CBaseAllocator

Constructor method.

Syntax

  CBaseAllocator(
    TCHAR *pName,
    LPUNKNOWN pUnk,
    HRESULT *phr,
    BOOL bEvent = TRUE,
    BOOL fEnableReleaseCallback  = FALSE
);

Parameters

pName

Pointer to a string containing the debug name of the allocator. For more information, see CBaseObject. 

pUnk

Pointer to the owner of this object. If the object is aggregated, pass a pointer to the aggregating object's IUnknown interface. Otherwise, set this parameter to NULL.

phr

Pointer to an HRESULT value. Set the value to S_OK before creating the object. If the constructor fails, the value is set to an error code.

bEvent

Boolean value indicating whether to create a semaphore. If TRUE, the allocator creates a semaphore (CBaseAllocator::m_hSem), which is signaled whenever a sample becomes available. Set the value to FALSE if you are implementing a derived class that does not require a semaphore.

fEnableReleaseCallback

Boolean value indicating whether the release callback mechanism is enabled. Set the value to TRUE if you want to supply a callback interface, which is called when buffers are released. Specify the callback by calling the CBaseAllocator::SetNotify method.

Requirements

**  Header:** Declared in Amfilter.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also