Método IAMExtTransport::SetEditPropertySet (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 SetEditPropertySet método registra um conjunto de propriedades de edição que descreve um grupo de propriedades de edição.

Este método não está implementado.

Sintaxe

HRESULT SetEditPropertySet(
  [in, out] long *pEditID,
  [in]      long State
);

Parâmetros

[in, out] pEditID

Ponteiro para um inteiro longo que especifica ou recebe um identificador para o conjunto de propriedades de edição.

[in] State

Especifica o estado do conjunto de propriedades de edição.

Valor Descrição
ED_ACTIVE Ativa o conjunto de propriedades de edição.
ED_DELETE Exclui o conjunto de propriedades de edição.
ED_INACTIVE Inativa o conjunto de propriedades de edição.
ED_REGISTER Registra o conjunto de propriedades de edição.
 

Se o valor for ED_REGISTER, o parâmetro pEditID receberá um identificador para o conjunto de propriedades de edição. Para os outros sinalizadores, use o parâmetro pEditID para especificar o identificador.

Retornar valor

Quando esse método é bem-sucedido, ele retorna S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Um evento de edição é um conjunto de parâmetros que definem uma sequência de gravação. Por exemplo, os parâmetros podem especificar modos de edição, pontos de entrada e pontos de saída ou buscar posições. Cada evento de edição consiste em um ou mais parâmetros, chamados editar propriedades. A coleção de propriedades é chamada de conjunto de propriedades de edição. Cada conjunto de propriedades de edição é identificado por um inteiro longo , atribuído pelo filtro de dispositivo.

Para criar e executar um evento de edição, o aplicativo deve fazer o seguinte:

  • Registre um conjunto de propriedades de edição. Chame o SetEditPropertySet método com o valor ED_REGISTER no parâmetro State . Quando o método retorna, o parâmetro pEditID contém o identificador do conjunto de propriedades de edição. Use esse número para identificar o conjunto de propriedades de edição em chamadas de método subsequentes.
  • Especifique as propriedades de edição usando o método IAMExtTransport::SetEditProperty .
  • Ative o evento de edição chamando SetEditPropertySet com o valor ED_ACTIVE.
  • Indira o transporte chamando SetEditProperty com o valor ED_EDIT_SEEK.
  • Execute o grafo de filtro.
Por exemplo, o código a seguir configura uma edição de inserção em todas as faixas:
C++
Registre uma ID de conjunto de propriedades de edição. (Faz com que a memória seja alocada.) editId longo; SetEditPropertySet(&EditId, ED_REGISTER);

Defina o modo de edição. SetEditProperty(EditId, ED_EDIT_MODE, ED_EDIT_MODE_INSERT); Defina as particularidades sobre o evento. SetEditProperty(EditId, ED_EDIT_TRACK, ED_VIDEO | ED_AUDIO_ALL); SetEditProperty(EditId, ED_REHEARSE_MODE, ED_EDIT_PERFORM);

Defina os tempos de origem e de registro. SetEditProperty(EditId, ED_EDIT_SRC_INPOINT, 200) SetEditProperty(EditId, ED_EDIT_SRC_OUTPOINT, 500) SetEditProperty(EditId, ED_EDIT_REC_INPOINT, 100) SetEditProperty(EditId, ED_EDIT_REC_OUTPOINT, 400)

Ative o evento de edição. SetEditPropertySet(&EditId, ED_ACTIVE); Indica o computador. SetEditProperty(EditId, ED_EDIT_SEEK, OATRUE);

// Run the graph. (Not shown.)

Implementação de DV

O MSDV não dá suporte a esse método. Ele retorna E_NOTIMPL.

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

Confira também

Códigos de erro e êxito

IAMExtTransport Interface

IAMExtTransport::GetEditPropertySet