Méthode IResourceManager ::CancelRequest (strmif.h)

Article
03/04/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 CancelRequest méthode annule la demande d’une ressource.

Syntaxe

HRESULT CancelRequest(
  [in] LONG              idResource,
  [in] IResourceConsumer *pConsumer
);

Paramètres

[in] idResource

Identificateur de ressource d’une requête en attente.

[in] pConsumer

Pointeur vers l’interface IResourceConsumer qui a effectué la demande.

Valeur retournée

Retourne une valeur HRESULT qui dépend de l’implémentation. HRESULT peut être l’une des constantes standard suivantes ou d’autres valeurs non répertoriées.

Code de retour	Description
E_FAIL	Échec.
E_POINTER	Argument pointeur NULL .
E_INVALIDARG	Argument non valide.
E_NOTIMPL	La méthode n’est pas prise en charge.
S_OK ou NOERROR	Réussite.

Remarques

Cette méthode doit être appelée lorsque l’objet IResourceConsumer qui a demandé la ressource ne l’a pas reçue et ne l’a plus besoin. S’il a déjà reçu la ressource, il doit utiliser la méthode IResourceManager ::NotifyRelease .

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

IResourceManager, interface

Partager via