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

Статья
02/07/2025

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

Поддерживается начиная с 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->PinToHandleNULL, KsCreatePin2 создает пин-код, который вызывающий объект может использовать для отправки запросов драйверу потоковой передачи, указанному в Connect->FilterHandle. Connect—>PinId определяет тип создаваемого пин-кода.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
IRQL	PASSIVE_LEVEL

См. также

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