Edit

PFNKSDEFAULTALLOCATE callback function (ks.h)

  • Article

An AVStream minidriver's AVStrMiniAllocate routine allocates a frame using the allocator specified in the Context parameter.

Syntax

PFNKSDEFAULTALLOCATE Pfnksdefaultallocate;

PVOID Pfnksdefaultallocate(
  [in] PVOID Context
)
{...}

Parameters

[in] Context

Pointer to the allocator's context structure created in AVStrMiniInitializeAllocator.

Return value

Allocate returns a pointer to the newly allocated memory. Return NULL if the attempt to allocate memory failed.

Remarks

The minidriver specifies this routine's address in the Allocate member of its KSALLOCATOR_DISPATCH structure. The minidriver passes this structure to the class driver in KSPIN_DISPATCH.

AVStream calls this routine to allocate a frame. The handler should allocate a frame as described by the allocator framing context passed into the initialization dispatch.

For more information, see KS Allocators.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Desktop
Header ks.h (include Ks.h)

See also

AVStrMiniInitializeAllocator

KSALLOCATOR_DISPATCH

KSPIN_DISPATCH