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

Статья
02/06/2025

Метод get возвращает свойство, определяемое идентификатором GUID набора свойств и идентификатором свойства.

Синтаксис

HRESULT Get(
  [in]  REFGUID rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

Параметры

[in] rguidPropSet

GUID, определяющий набор свойств.

[in] ulId

Идентификатор свойства в наборе свойств.

[in] pInstanceData

Указатель на данные экземпляра свойства.

[in] ulInstanceLength

Размер буфера в байтах в InstanceData.

[out] pPropertyData

Указатель на буфер, получающий значение свойства.

[in] ulDataLength

Размер буфера в байтах в PropertyData.

[out] pulBytesReturned

Указатель на переменную, которая получает размер в байтах данных, которые Get хранятся в буфере в PropertyData.

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

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

Замечания

Чтобы получить свойство, выделите буфер, который Get заполняется свойством. Чтобы определить необходимый размер буфера, укажите NULL для PropertyData и ноль для DataLength. Метод get возвращает требуемый размер буфера в BytesReturned.

Предупреждение

Файлы заголовков ksproxy.h и dsound.h определяют аналогичные, но несовместим ые версии интерфейса IKsPropertySet. Приложения, требующие модуля прокси-сервера KS, должны использовать версию, определенную в ksproxy.h. Версия DirectSound IKsPropertySet описана на справочных страницах DirectSound в документации по пакету SDK для Microsoft Windows. Если приложение должно включать как ksproxy.h, так и dsound.h, независимо от файла заголовка, который сначала сканирует компилятор, является тот, чье определение IKsPropertySet используется компилятором.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dsound.h (include Ksproxy.h, Dsound.h)

См. также

IKsPropertySet::Set

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