Método IKsPropertySet::Get (dsound.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 rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

Parámetros

[in] rguidPropSet

GUID que identifica el conjunto de propiedades.

[in] ulId

Identificador de la propiedad dentro del conjunto de propiedades.

[in] pInstanceData

Puntero a los datos de instancia de la propiedad .

[in] ulInstanceLength

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

[out] pPropertyData

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

[in] ulDataLength

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

[out] pulBytesReturned

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. La versión directSound de IKsPropertySet se describe en las páginas de referencia de DirectSound de la documentación de Microsoft Windows SDK. 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	dsound.h (include Ksproxy.h, Dsound.h)

Consulte también

IKsPropertySet::Set