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

Статья
02/29/2024

Метод 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)

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

IKsPropertySet::Set

Share via