Método IPropertySetter::GetProps
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
Observação
[Preterido. Essa API pode ser removida de versões futuras do Windows.]
O GetProps método recupera as propriedades definidas neste objeto, com seus valores correspondentes.
Sintaxe
HRESULT GetProps(
[out] LONG *pcParams,
[out] DEXTER_PARAM **paParam,
[out] DEXTER_VALUE **paValue
);
Parâmetros
-
pcParams [out]
-
Recebe o número de estruturas retornadas no paParam.
-
paParam [out]
-
Endereço de um ponteiro para uma matriz de estruturas DEXTER_PARAM .
-
paValue [out]
-
Endereço de um ponteiro para uma matriz de estruturas DEXTER_VALUE .
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Para cada propriedade retornada no paParam, o membro nValues indica o número de estruturas de DEXTER_VALUE associadas à propriedade . Os pares são retornados em ordem de tempo crescente para cada propriedade.
Quando terminar de usar as estruturas retornadas, chame IPropertySetter::FreeProps para liberar os recursos alocados por esse método.
Observação
O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.
Observação
Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.
Exemplos
O exemplo de código a seguir mostra como iterar todos os valores em uma instância do setter de propriedade:
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 | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também