Método IMemAllocatorCallbackTemp::SetNotify (strmif.h)
[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 SetNotify método define ou remove um retorno de chamada no alocador. O alocador chama o método de retorno de chamada sempre que o método IMemAllocator::ReleaseBuffer do alocador é chamado.
Sintaxe
HRESULT SetNotify(
IMemAllocatorNotifyCallbackTemp *pNotify
);
Parâmetros
pNotify
Ponteiro para a interface IMemAllocatorNotifyCallbackTemp que será usada para o retorno de chamada. O chamador deve implementar a interface . Use o valor NULL para remover o retorno de chamada.
Retornar valor
Retorna S_OK se tiver êxito ou um código de erro de outra forma.
Comentários
Sempre que o método ReleaseBuffer do alocador é chamado, o alocador chama o método NotifyRelease na interface fornecida em pNotify. O método ReleaseBuffer retorna um exemplo de mídia para a lista gratuita do alocador. Exemplos chamam esse método quando suas contagens de referência atingem zero.
O alocador contém uma contagem de referência na interface IMemAllocatorNotifyCallbackTemp do chamador. Isso pode criar contagens de referência circular, impedindo assim que objetos no grafo sejam liberados corretamente. Portanto, quando o chamador não precisar mais de notificações de retorno de chamada, ele deverá chamar esse método novamente com o valor NULL. Um momento apropriado para fazer isso é quando o grafo é interrompido ou quando os pinos são desconectados.
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 |