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) |