Compartir a través de


Método IKsPropertySet::Get (ksproxy.h)

El método Get recupera una propiedad identificada por un GUID de conjunto de propiedades y un identificador de propiedad.

Sintaxis

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

Parámetros

[in] PropSet

GUID que identifica el conjunto de propiedades.

[in] Id

Identificador de la propiedad dentro del conjunto de propiedades.

[in] InstanceData

Puntero a los datos de instancia de la propiedad .

[in] InstanceLength

Tamaño, en bytes, del búfer en InstanceData.

[out] PropertyData

Puntero a un búfer que recibe el valor de la propiedad .

[in] DataLength

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 Obtener almacena en el búfer en PropertyData.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Observaciones

Para recuperar una propiedad, asigne un búfer, que Obtener rellena con la propiedad . Para determinar el tamaño de búfer necesario, especifique NULL para PropertyData y cero para DataLength. El método Get devuelve el tamaño de búfer necesario en BytesReturned.

Advertencia

Los archivos de encabezado ksproxy.h y dsound.h definen versiones similares pero incompatibles de la interfaz IKsPropertySet. Las aplicaciones que requieren el módulo de proxy KS deben usar la versión definida en ksproxy.h. Si una aplicación debe incluir ksproxy.h y dsound.h, el archivo de encabezado que examina el compilador primero es el que primero usa la definición de IKsPropertySet.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de ksproxy.h (incluya Ksproxy.h, Dsound.h)

Consulte también

IKsPropertySet::Set