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

Функция 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 см. в документации по Microsoft Windows SDK.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ksproxy.h (включая Ksproxy.h)
Библиотека	Ksproxy.lib

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

IKsPinFactory

KSPROPERTY

KSPROPSETID_Pin

KSP_PIN