Compartir a través de


Método IPropertySetter::GetProps

[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.

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.

 

El GetProps método recupera las propiedades establecidas en este objeto, con sus valores correspondientes.

Sintaxis

HRESULT GetProps(
  [out] LONG         *pcParams,
  [out] DEXTER_PARAM **paParam,
  [out] DEXTER_VALUE **paValue
);

Parámetros

pcParams [out]

Recibe el número de estructuras devueltas en paParam.

paParam [out]

Dirección de un puntero a una matriz de estructuras DEXTER_PARAM .

paValue [out]

Dirección de un puntero a una matriz de estructuras DEXTER_VALUE .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Para cada propiedad devuelta en paParam, el miembro nValues indica el número de estructuras DEXTER_VALUE asociadas a la propiedad . Los pares se devuelven en orden de tiempo ascendente para cada propiedad.

Cuando haya terminado de usar las estructuras devueltas, llame a IPropertySetter::FreeProps para liberar los recursos asignados por este método.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Ejemplos

En el ejemplo de código siguiente se muestra cómo recorrer en iteración todos los valores de una instancia del establecedor de propiedades:

IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).

DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;

hr = pSetter->GetProps(&count, &pParam, &pValue);

LONG num = 0;
for (LONG i = 0; i < count; i++)
{
    for (LONG j = 0; j < pParam[i].nValues; j++)
    {
        // pValue[num] is the next value in the sequence for pParam[i]
    }
    num += pParam[i].nValues;
}

Requisitos

Requisito Value
Encabezado
Qedit.h
Biblioteca
Strmiids.lib

Consulte también

Interfaz IPropertySetter

Códigos de error y éxito