Функция KsGetMultiplePinFactoryItems (ksproxy.h)

Статья
02/07/2025

Функция KsGetMultiplePinFactoryItems извлекает элементы свойств закрепления в буфере данных переменной длины.

Синтаксис

KSDDKAPI HRESULT KsGetMultiplePinFactoryItems(
  [in]  HANDLE FilterHandle,
  [in]  ULONG  PinFactoryId,
  [in]  ULONG  PropertyId,
  [out] PVOID  *Items
);

Параметры

[in] FilterHandle

Дескриптор фильтра, содержащего фабрику контактов для запроса.

[in] PinFactoryId

Идентификатор фабрики закреплений, в которой возвращаются элементы свойства.

[in] PropertyId

Идентификатор свойства в наборе свойств пин-кода (KSPROPSETID_Pin) для запроса.

[out] Items

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

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

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

Замечания

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

Дополнительные сведения о CoTaskMemFreeсм. в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	ksproxy.h (включая Ksproxy.h)
библиотеки	Ksproxy.lib

См. также

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