Метод IKsPropertySet::Get (ksproxy.h)
Метод Get извлекает свойство, определяемое идентификатором GUID набора свойств и идентификатором свойства.
Синтаксис
HRESULT Get(
[in] REFGUID PropSet,
[in] ULONG Id,
[in] LPVOID InstanceData,
[in] ULONG InstanceLength,
[out] LPVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
Параметры
[in] PropSet
ИДЕНТИФИКАТОР GUID, идентифицирующий набор свойств.
[in] Id
Идентификатор свойства в наборе свойств.
[in] InstanceData
Указатель на данные экземпляра для свойства .
[in] InstanceLength
Размер (в байтах) буфера в InstanceData.
[out] PropertyData
Указатель на буфер, получающий значение свойства .
[in] DataLength
Размер буфера в байтах в PropertyData.
[out] BytesReturned
Указатель на переменную, которая получает размер (в байтах) данных, которые Get хранит в буфере propertyData.
Возвращаемое значение
В случае успешного выполнения возвращает значение NOERROR; в противном случае возвращает код ошибки.
Комментарии
Чтобы получить свойство, выделите буфер, который get заполняет свойством . Чтобы определить необходимый размер буфера, укажите значение NULL в параметре PropertyData и ноль для DataLength. Метод Get возвращает требуемый размер буфера в BytesReturned.
Предупреждение
Файлы заголовков ksproxy.h и dsound.h определяют похожие, но несовместимые версии интерфейса IKsPropertySet . Приложения, которым требуется прокси-модуль KS, должны использовать версию, определенную в ksproxy.h. Если приложение должно включать как ksproxy.h , так и dsound.h, то в зависимости от того, какой файл заголовка сначала сканирует компилятор, будет использоваться определение IKsPropertySet компилятором.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ksproxy.h (включая Ksproxy.h, Dsound.h) |