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


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

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

Поддерживается начиная с 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

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

CoInitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin