Функция 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 |