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


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

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

Синтаксис

NTSTATUS KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] PVOID       PropertyData,
  [in]      ULONG       DataLength,
  [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.

[out] BytesReturned

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

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

Метод IKsControl::KsProperty возвращает то же значение, которое будет возвращено, если свойство было отправлено IOCTL.

Замечания

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

Требования

Требование Ценность
целевая платформа DesktopMobile
заголовка ks.h (include Ks.h)

См. также

KSPROPERTY

KSPROPERTY_ITEM

KSPROPERTY_SET