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