Metodo IAMResourceControl::Reserve (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il Reserve metodo riserva o annulla la riserva di una risorsa del dispositivo.
Sintassi
HRESULT Reserve(
[in] DWORD dwFlags,
[in] PVOID pvReserved
);
Parametri
[in] dwFlags
Flag che indica se riservare o annullare la riserva di questo dispositivo. Il valore deve essere un membro dell'enumerazione AMRESCTL_RESERVEFLAGS .
[in] pvReserved
Deve essere NULL.
Valore restituito
Restituisce S_OK se il dispositivo è stato riservato o non aggiornato, S_FALSE se il dispositivo è attualmente riservato e continuerà a essere mantenuto o un codice di errore HRESULT se il dispositivo non può essere riservato.
Commenti
Una risorsa può essere riservata più volte. Se il metodo restituisce S_OK, il filtro incrementa un numero di riserva interno. Per ogni chiamata per riservare un dispositivo che restituisce S_OK, il chiamante deve effettuare una chiamata corrispondente per annullare la riserva del dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |