Метод IKsControl::KsProperty (ksproxy.h)

Статья
08/07/2023

Метод KsProperty задает свойство или извлекает сведения о свойстве, а также любые другие определенные операции поддержки, доступные в наборе свойств.

Синтаксис

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, out] ULONG       *BytesReturned
);

Параметры

[in] Property

Указатель на структуру, описывающую свойство, и тип запроса на свойство. Эта структура должна быть либо KSPROPERTY , либо структурой, которая содержит структуру KSPROPERTY в качестве первого члена. Примером структуры, на которую может указывать этот элемент, является структура KSPROPERTY_VIDEOPROCAMP_S .

[in] PropertyLength

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

[in, out] PropertyData

Указатель на буфер, содержащий данные для KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET или KSPROPERTY_TYPE_UNSERIALIZERAW операции, или буферное пространство, которое получает данные для всех остальных операций.

[in] DataLength

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

[in, out] BytesReturned

Указатель на переменную, которая получает размер (в байтах) данных, которые KsProperty хранит в буфере в propertyData. Если данные не хранятся, размер равен нулю.

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

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

Чтобы определить размер буфера, необходимый для конкретного запроса на свойство, можно вызвать этот метод с параметром PropertyData со значением NULL , а DataLength равным нулю. Метод возвращает HRESULT_FROM_WIN32(ERROR_MORE_DATA), а BytesReturned содержит размер требуемого буфера.

Требования

Требование	Значение
Целевая платформа	DesktopMobile
Верхняя часть	ksproxy.h (включая Ksproxy.h)

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

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S

Share via