Metodo IVMRSurfaceAllocator::P repareSurface (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il PrepareSurface metodo prepara la superficie DirectDraw in modo che il fotogramma video successivo venga decodificato.
Sintassi
HRESULT PrepareSurface(
[in] DWORD_PTR dwUserID,
[in] LPDIRECTDRAWSURFACE7 lpSurface,
[in] DWORD dwSurfaceFlags
);
Parametri
[in] dwUserID
Un cookie di DWORD_PTR definito dall'applicazione che identifica in modo univoco questa istanza di VMR da usare negli scenari in cui un'istanza del relatore allocatore viene usata con più istanze di VMR.
[in] lpSurface
Specifica la superficie DirectDraw
[in] dwSurfaceFlags
Parola doppia contenente i flag di superficie. Vedere la sezione Osservazioni.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.
Commenti
L'unico flag attualmente controllato da VMR è AM_GBF_NOTASYNCPOINT (0x00000002), che indica che non si sta per riempire il buffer con un punto di sincronizzazione (fotogramma chiave).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP1 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |