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