Método IKsControl::KsProperty (ksproxy.h)
El método KsProperty establece una propiedad o recupera información de propiedad, junto con cualquier otra operación de soporte técnico definida disponible en un conjunto de propiedades.
Sintaxis
HRESULT KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] LPVOID PropertyData,
[in] ULONG DataLength,
[in, 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
Tamaño, en bytes, del búfer en Propiedad.
[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
Tamaño, en bytes, del búfer en PropertyData.
[in, 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
Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.
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 | ksproxy.h (incluya Ksproxy.h) |