Функция KsCreateAllocator (ks.h)

Функция KsCreateAllocator создает дескриптор для распределителя для заданного дескриптора соединения приемника. Эта функция не завершает IRP и не задает состояние в IRP.

Синтаксис

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

Параметры

[in] ConnectionHandle

Указывает дескриптор соединения приемника, на котором создается распределитель.

[in] AllocatorFraming

Указанная обрамления для распределителя.

[out] AllocatorHandle

Указывает указатель на дескриптор для хранения дескриптора распределителя.

Возвращаемое значение

Функция KsCreateAllocator возвращает STATUS_SUCCESS в случае успешного выполнения или ошибку в случае неудачи.

Комментарии

Существует две версии функции KsCreateAllocator : одна для клиентов в пользовательском режиме и одна для клиентов в режиме ядра. Эту функцию можно вызывать только в PASSIVE_LEVEL для клиентов в режиме ядра.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib
IRQL PASSIVE_LEVEL (см. раздел "Примечания")

См. также раздел

KSALLOCATOR_FRAMING