KSALLOCATOR_DISPATCH structure

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

Version

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

 

 

Send comments about this topic to Microsoft

Show: