KsCreateAllocator2 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.

Supported starting in Windows 8.

Syntax


 KSDDKAPI HRESULT WINAPI KsCreateAllocator2(
  _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]

A pointer to a KSALLOCATOR_FRAMING structure that specifies framing for the allocator.

AllocatorHandle [out]

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

Return value

Returns NOERROR if successful; otherwise, returns an error code.

Remarks

This is a new version of the KsCreateAllocator function and uses the device broker to create the handle to the kernel streaming object. In addition, the Component Object Model (COM) CoInitialize function must be called before this function is called.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Target platform

Universal

Header

Ks.h (include Ks.h)

IRQL

PASSIVE_LEVEL

See also

CoInitialize
KSALLOCATOR_FRAMING
KsCreateAllocator

 

 

Send comments about this topic to Microsoft

Show: