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

Voir aussi

Codes d’erreur et de réussite

IAMResourceControl, interface