Método IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator (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 AdviseSurfaceAllocator método é chamado por um aplicativo para instruir a VMR a usar um alocador-apresentador personalizado.
Sintaxe
HRESULT AdviseSurfaceAllocator(
[in] DWORD_PTR dwUserID,
[in] IVMRSurfaceAllocator *lpIVRMSurfaceAllocator
);
Parâmetros
[in] dwUserID
Um DWORD_PTR definido pelo aplicativo que identifica exclusivamente essa instância da VMR em cenários em que várias instâncias da VMR estão sendo usadas com uma única instância de um alocador-apresentador.
[in] lpIVRMSurfaceAllocator
Especifica a interface IVMRSurfaceAllocator no novo alocador-apresentador. Se esse valor for NULL, a VMR liberará o alocador-apresentador do cliente e restaurará seu alocador-apresentador padrão.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
O método fará com que o alocador-apresentador padrão seja desinstalado e destruído e substituído pelo novo componente especificado. O novo componente também deve dar suporte à interface IVMRImagePresenter .
Esse método pode ser chamado apenas uma vez no tempo de vida da VMR. A VMR continua a usar o alocador-apresentador até que a VMR seja excluída. Quando a VMR é finalmente liberada, ela libera sua contagem de referência no objeto personalizado allocator-presenter, que permite que esse objeto seja liberado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |