Метод 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), а BytesReturned содержит размер требуемого буфера.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | DesktopMobile |
| Верхняя часть | ks.h (включая Ks.h) |