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

Vedi anche

Codici errore e esito positivo

Interfaccia IAMResourceControl