KsCreateAllocator

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.

KSDDKAPI NTSTATUS NTAPI
  KsCreateAllocator(
    IN HANDLE  ConnectionHandle,
    IN PKSALLOCATOR_FRAMING  AllocatorFraming,
    OUT PHANDLE  AllocatorHandle
    ); 

Parameters

ConnectionHandle

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

AllocatorFraming

Specified framing for the allocator.

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.

Headers

Declared in ks.h. Include ks.h.

Comments

There are two versions of thhe 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.

See Also

KSALLOCATOR_FRAMING