IAMResourceControl ::Reserve, méthode (strmif.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La Reserve méthode réserve ou annule la réserve d’une ressource d’appareil.
Syntaxe
HRESULT Reserve(
[in] DWORD dwFlags,
[in] PVOID pvReserved
);
Paramètres
[in] dwFlags
Indicateur indiquant s’il faut réserver ou annuler la réservation de cet appareil. La valeur doit être membre de l’énumération AMRESCTL_RESERVEFLAGS .
[in] pvReserved
Doit être NULL.
Valeur retournée
Retourne S_OK si l’appareil a été correctement réservé ou non, S_FALSE si l’appareil est actuellement réservé et continuera à être conservé, ou un code d’erreur HRESULT si l’appareil ne peut pas être réservé.
Remarques
Une ressource peut être réservée plusieurs fois. Si la méthode retourne S_OK, le filtre incrémente un nombre de réserves internes. Pour chaque appel pour réserver un appareil qui retourne S_OK, l’appelant doit effectuer un appel correspondant pour annuler la réservation de l’appareil.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |