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

Статья
02/07/2025

Функция KsValidateConnectRequest проверяет запрос подключения и возвращает указатель на структуру подключения, связанную с запросом.

Эта функция может вызываться только в PASSIVE_LEVEL.

Синтаксис

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

Параметры

[in] Irp

Указатель на IRP, указывающий запрос на подключение.

[in] DescriptorsCount

Указывает количество переданных дескрипторов пин-кода.

[in] Descriptor

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

[out] Connect

Указывает расположение, в котором нужно поместить указатель на указатель KSPIN_CONNECT, переданный в запрос на создание. Если KsValidateConnectRequest возвращает успешное выполнение, то Connect+1 будет содержать указатель на KSDATAFORMAT, с помощью которого был открыт пин-код.

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

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

Замечания

Функция KsValidateConnectRequest обрабатывает основные исключения доступа к структуре подключения и проверяет требования к обмену данными, средний, протокол и базовый формат данных. Проверка, выполняемая в формате данных, основана на списке диапазонов данных для указанного пин-кода, для которого создается экземпляр пин-кода. Проверка успешно выполняется в трех экземплярах: если основной формат диапазона является подстановочным знаком, то основной формат диапазона совпадает, а подформат диапазона — подстановочный знак, или основной формат диапазона, подформат диапазона и описатель диапазона все совпадения.

Буфер передает копию исходного входного буфера, если исходный буфер не был в режиме ядра и поэтому является безопасным для доступа.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib

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