KsCreateAllocator function

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


NTSTATUS KsCreateAllocator(
  _In_  HANDLE               ConnectionHandle,
  _In_  PKSALLOCATOR_FRAMING AllocatorFraming,
  _Out_ PHANDLE              AllocatorHandle
);

Parameters

ConnectionHandle [in]

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

AllocatorFraming [in]

Specified framing for the allocator.

AllocatorHandle [out]

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

Target platform

Universal

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

PASSIVE_LEVEL (See Remarks section)

See also

KSALLOCATOR_FRAMING

 

 

Send comments about this topic to Microsoft

Show: