Edit

Share via

KsCreateAllocator function (ks.h)

  • Article

The KsCreateAllocator function creates a handle to an allocator for the given sink connection handle. This function does not complete the IRP or set the status in the IRP.

Syntax

KSDDKAPI NTSTATUS KsCreateAllocator(
  [in]  HANDLE               ConnectionHandle,
  [in]  PKSALLOCATOR_FRAMING AllocatorFraming,
  [out] PHANDLE              AllocatorHandle
);

Parameters

[in] ConnectionHandle

Specifies the handle to the sink connection on which to create the allocator.

[in] AllocatorFraming

Specified framing for the allocator.

[out] AllocatorHandle

Specifies the pointer to a handle to store the allocator handle.

Return value

The KsCreateAllocator function returns STATUS_SUCCESS if successful, or it returns an error if unsuccessful.

Remarks

There are two versions of the KsCreateAllocator function: one for user-mode clients and one for kernel-mode clients. This function can only be called at PASSIVE_LEVEL for kernel-mode clients.

Requirements

Requirement Value
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL (See Remarks section)

See also

KSALLOCATOR_FRAMING