Método IKsPropertySet::Set
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 Set método define uma propriedade identificada por um GUID do conjunto de propriedades e uma ID de propriedade.
Sintaxe
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 do conjunto de propriedades.
-
dwPropID [in]
-
Identificador da propriedade dentro do conjunto de propriedades.
-
pInstanceData [in]
-
Ponteiro para um buffer que contém dados de instância para a propriedade .
-
cbInstanceData [in]
-
Tamanho do buffer pInstanceData , em bytes.
-
pPropData [in]
-
Ponteiro para um buffer que contém o valor da propriedade .
-
cbPropData [in]
-
Sise do buffer pPropData , em bytes.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Não há suporte para o conjunto de propriedades. |
|
Não há suporte para a ID da propriedade para o conjunto de propriedades especificado. |
Comentários
Observação
Outra interface com esse nome existe no arquivo de cabeçalho dsound.h. As duas interfaces não são compatíveis. A interface IKsControl , documentada no DDK do DirectShow, agora é a interface recomendada para passar conjuntos de propriedades entre drivers WDM e componentes do modo de usuário.
Você deve incluir Ks.h antes de Ksproxy.h.
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] |
| Cabeçalho |
|
| Biblioteca |
|
Confira também