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

Статья
02/07/2025

Метод 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), а БайтReturned содержит размер требуемого буфера.

Требования

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

См. также

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S

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