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

El método Get recupera una propiedad identificada por un GUID del 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 Get almacena en el búfer en PropertyData.

Valor devuelto

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

Comentarios

Para recuperar una propiedad, asigne un búfer, que Get 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 examine primero el compilador es el que usa la definición de IKsPropertySet .

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	ksproxy.h (incluya Ksproxy.h, Dsound.h)

Consulte también

IKsPropertySet::Set