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

Метод 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 в документации по Microsoft Windows SDK. Если приложение должно включать как ksproxy.h , так и dsound.h, то в зависимости от того, какой файл заголовка сначала сканирует компилятор, будет использоваться определение IKsPropertySet компилятором.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dsound.h (включая Ksproxy.h, Dsound.h)

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

IKsPropertySet::Set