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

Статья
02/07/2025

Функция KsPinPropertyHandler выполняет стандартную обработку статических элементов набором свойств KSPROPSETID_Pin. Эта обработка не включает KSPROPERTY_PIN_CINSTANCES или KSPROPERTY_PIN_DATAINTERSECTION.

Синтаксис

KSDDKAPI NTSTATUS KsPinPropertyHandler(
  [in]      PIRP                   Irp,
  [in]      PKSPROPERTY            Property,
  [in, out] PVOID                  Data,
  [in]      ULONG                  DescriptorsCount,
  [in]      const KSPIN_DESCRIPTOR *Descriptor
);

Параметры

[in] Irp

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

[in] Property

Указывает сведения о конкретном свойстве.

[in, out] Data

Указывает параметр данных, сопоставленный с системным адресом. Это тот же параметр, который передается обработчику свойств через обратный вызов KsPropertyHandler.

[in] DescriptorsCount

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

[in] Descriptor

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

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

Функция KsPinPropertyHand ler возвращает STATUS_SUCCESS или ошибку, определенную для обрабатываемого свойства. Функция заполняет IO_STATUS_BLOCK. Информационное поле ПИРП. Элемент IoStatus в IRP. Он не задает IO_STATUS_BLOCK. Поле состояния и не завершите IRP.

Замечания

Не используйте функцию KsPinPropertyHandler для определения набора свойств пин-кода; Набор свойств пин-кода можно проще определить с помощью макроса DEFINE_KSPROPERY_PINSET.

Требования

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

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