Metodo IPropertySetter::GetProps

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetProps metodo recupera le proprietà impostate su questo oggetto, con i relativi valori corrispondenti.

Sintassi

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

Parametri

pcParams [out]

Riceve il numero di strutture restituite in paParam.

paParam [out]

Indirizzo di un puntatore a una matrice di strutture DEXTER_PARAM .

paValue [out]

Indirizzo di un puntatore a una matrice di strutture DEXTER_VALUE .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per ogni proprietà restituita in paParam, il membro nValues indica il numero di strutture DEXTER_VALUE associate alla proprietà. Le coppie vengono restituite in ordine temporale crescente per ogni proprietà.

Al termine dell'uso delle strutture restituite, chiamare IPropertySetter::FreeProps per liberare le risorse allocate da questo metodo.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'iterazione di tutti i valori in un'istanza del setter della proprietà:

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;
}

Requisiti

Vedi anche

Interfaccia IPropertySetter

Codici errore e esito positivo