Método CImageAllocator.NotifyMediaType
[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 NotifyMediaType método informa o objeto do tipo de mídia atual.
Sintaxe
void NotifyMediaType(
CMediaType *pMediaType
);
Parâmetros
-
pMediaType
-
Ponteiro para um objeto CMediaType ou NULL para limpar o tipo de mídia.
Retornar valor
Esse método não retorna um valor.
Comentários
O filtro proprietário deve chamar esse método sempre que o tipo de mídia for alterado. Normalmente, isso ocorre quando o pino se conecta pela primeira vez e após uma alteração de formato dinâmico. O alocador usa o tipo de mídia para validar as propriedades do alocador propostas e também quando cria amostras de mídia.
O objeto CImageAllocator armazena o ponteiro pMediaType na variável de membro m_pMediaType . Portanto, se o chamador precisar liberar o objeto CMediaType , ele deverá atualizar o alocador chamando esse método novamente, com um novo ponteiro ou com um valor NULL . Caso contrário, um erro poderá ocorrer quando o alocador tentar referenciar o ponteiro antigo.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|