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)

Consulte también

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S