Метод IKsPropertySet::Get (ksproxy.h)

Статья
02/07/2025

Метод 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 (include Ksproxy.h, Dsound.h)

См. также

IKsPropertySet::Set

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