Edit

KSALLOCATOR_DISPATCH structure (ks.h)

  • Article

The KSALLOCATOR_DISPATCH structure contains the callbacks required for a pin to implement its own kernel-level allocator.

Syntax

typedef struct _KSALLOCATOR_DISPATCH {
  PFNKSPININITIALIZEALLOCATOR InitializeAllocator;
  PFNKSDELETEALLOCATOR        DeleteAllocator;
  PFNKSDEFAULTALLOCATE        Allocate;
  PFNKSDEFAULTFREE            Free;
} KSALLOCATOR_DISPATCH, *PKSALLOCATOR_DISPATCH;

Members

InitializeAllocator

A pointer to a minidriver-supplied AVStrMiniInitializeAllocator callback routine.

DeleteAllocator

A pointer to a minidriver-supplied AVStrMiniDeleteAllocator callback routine.

Allocate

A pointer to a minidriver-supplied AVStrMiniAllocate callback routine.

Free

A pointer to a minidriver-supplied AVStrMiniAllocatorFreeFrame callback routine.

Remarks

By providing a pointer to a KSALLOCATOR_DISPATCH structure in the relevant KSPIN_DISPATCH structure, a minidriver declares that the corresponding pin is capable of performing kernel-level allocation. The allocator might or might not be used by the graph manager. Note that memory allocated at kernel level cannot be passed to a user-mode filter.

Requirements

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

See also

KSPIN_DISPATCH