Método IMediaPropertyBag::EnumProperty (strmif.h)
[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.]
O EnumProperty método recupera um par propriedade/valor.
Sintaxe
HRESULT EnumProperty(
[in] ULONG iProperty,
[in, out] VARIANT *pvarPropertyName,
[in, out] VARIANT *pvarPropertyValue
);
Parâmetros
[in] iProperty
Valor de índice do par.
[in, out] pvarPropertyName
Ponteiro para um VARIANT que recebe o nome da propriedade.
[in, out] pvarPropertyValue
Ponteiro para um VARIANT que recebe o valor da propriedade.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Argumento inválido. |
|
Memória insuficiente. |
|
Argumento de ponteiro NULL. |
|
Índice fora do intervalo. |
Comentários
O nome é sempre uma cadeia de caracteres. Defina o tipo variante do parâmetro pvarPropertyName como VT_EMPTY ou VT_BSTR antes de chamar esse método.
O valor pode ser uma cadeia de caracteres (para partes INFO) ou uma matriz de bytes (para partes DISP). Defina o tipo de variante do parâmetro pvarPropertyName como VT_EMPTY, VT_BSTR ou (VT_ARRAY | VT_UI1).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |