Método IKsControl::KsProperty (ks.h)
El método IKsControl::KsProperty establece una propiedad o recupera información de propiedad, junto con cualquier otra operación de compatibilidad definida disponible en un conjunto de propiedades.
Sintaxis
NTSTATUS KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] PVOID PropertyData,
[in] ULONG DataLength,
[out] ULONG *BytesReturned
);
Parámetros
[in] Property
Puntero a una estructura que describe una propiedad y el tipo de solicitud de la solicitud de propiedad. Esta estructura debe ser KSPROPERTY o una estructura que contenga una estructura KSPROPERTY como su primer miembro. Un ejemplo de una estructura a la que puede apuntar este miembro es la estructura KSPROPERTY_VIDEOPROCAMP_S .
[in] PropertyLength
Especifica el tamaño, en bytes, del búfer en Property.
[in, out] PropertyData
Puntero a un búfer que contiene datos para una operación de KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET o KSPROPERTY_TYPE_UNSERIALIZERAW, o espacio de búfer que recibe datos para todas las demás operaciones.
[in] DataLength
Especifica el tamaño, en bytes, del búfer en PropertyData.
[out] BytesReturned
Puntero a una variable que recibe el tamaño, en bytes, de los datos que KsProperty almacena en el búfer en PropertyData. Si no se almacenan datos, el tamaño es cero.
Valor devuelto
El método IKsControl::KsProperty devuelve el mismo valor que se devolvería si IOCTL hubiera enviado la propiedad.
Comentarios
Para determinar el tamaño del búfer necesario para una solicitud de propiedad específica, puede llamar a este método con PropertyData establecido en NULL y DataLength igual a cero. El método devuelve HRESULT_FROM_WIN32(ERROR_MORE_DATA) y BytesReturned contiene el tamaño del búfer necesario.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | DesktopMobile |
| Encabezado | ks.h (incluye Ks.h) |