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

Статья
08/07/2023

Передает запрос на подключение устройству, создавая экземпляр закрепления.

Поддерживается начиная с Windows 8.

Синтаксис

KSDDKAPI HRESULT KsCreatePin2(
  [in]  HANDLE         FilterHandle,
  [in]  PKSPIN_CONNECT Connect,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        ConnectionHandle
);

Параметры

[in] FilterHandle

Указывает дескриптор фильтра, инициирующего запрос на создание, и место соединения.

[in] Connect

Указатель на структуру KSPIN_CONNECT , содержащую параметры для запрошенного подключения. За этим в памяти должна следовать структура данных KSDATAFORMAT , описывающая формат данных, запрошенный для подключения.

[in] DesiredAccess

Указывает требуемый доступ к закреплению. Обычно это GENERIC_READ или GENERIC_WRITE. Для данных, передаваемых в контакт, это значение должно быть равно GENERIC_WRITE, а для данных, поступающих из контакта, должно быть задано значение GENERIC_READ независимо от метода связи.

[out] ConnectionHandle

Указывает переданный дескриптор соединения. Подпрограмма заполняет его дескриптором для объекта файла созданного соединения. Затем это значение можно использовать для отключения функции CloseHandle .

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

В случае успешного выполнения возвращает значение NOERROR ; в противном случае возвращает код ошибки.

Это новая версия функции KsCreatePin , использующая брокер устройства для создания дескриптора для объекта потоковой передачи ядра. Кроме того, перед вызовом этой функции необходимо вызвать функцию COM CoInitialize .

Подпрограмма отправляет драйверу запрос IRP_MJ_CREATE . Драйвер принимает запрос, только если интерфейс, среда и формат данных совместимы.

Если параметрConnect-PinToHandle> имеет значение NULL, KsCreatePin2 создает контакт, который вызывающий объект может использовать для отправки запросов к драйверу потоковой передачи, указанному в параметре Connect-FilterHandle>. Connect-PinId> определяет тип создаваемого контакта.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)
IRQL	PASSIVE_LEVEL

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

Поделиться через