Compartir a través de


Método IKsPropertySet::Set

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

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

Sintaxis

HRESULT Set(
  [in] REFGUID guidPropSet,
  [in] DWORD   dwPropID,
  [in] LPVOID  pInstanceData,
  [in] DWORD   cbInstanceData,
  [in] LPVOID  pPropData,
  [in] DWORD   cbPropData
);

Parámetros

guidPropSet [in]

GUID del conjunto de propiedades.

dwPropID [in]

Identificador de la propiedad dentro del conjunto de propiedades.

pInstanceData [in]

Puntero a un búfer que contiene datos de instancia para la propiedad .

cbInstanceData [in]

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

pPropData [in]

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

cbPropData [in]

Sise del búfer pPropData , en bytes.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
Correcto.
E_PROP_SET_UNSUPPORTED
No se admite el conjunto de propiedades.
E_PROP_ID_UNSUPPORTED
El identificador de propiedad no se admite para el conjunto de propiedades especificado.

 

Observaciones

Nota:

Existe otra interfaz por este nombre en el archivo de encabezado dsound.h. Las dos interfaces no son compatibles. La interfaz IKsControl , documentada en DirectShow DDK, es ahora la interfaz recomendada para pasar conjuntos de propiedades entre controladores WDM y componentes de modo de usuario.

 

Debe incluir Ks.h antes de Ksproxy.h.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Ksproxy.h
Biblioteca
Strmiids.lib

Consulte también

Códigos de error y éxito

Interfaz IKsPropertySet

Conjuntos de propiedades