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

Article
03/02/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 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 NotifyAcquire méthode avertit le gestionnaire de ressources qu’une tentative d’acquisition d’une ressource est terminée.

Syntaxe

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

Paramètres

[in] idResource

Jeton pour la ressource inscrite.

[in] pConsumer

Pointeur vers l’interface IResourceConsumer de l’objet qui demande la ressource.

[in] hr

Valeur indiquant le succès de l’acquisition ; S_OK si la ressource a été acquise, ou une valeur d’erreur dans le cas contraire.

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

Utilisez cette méthode après qu’une méthode IResourceConsumer ::AcquireResource retourne une valeur S_FALSE, indiquant que l’acquisition sera asynchrone (c’est-à-dire gérée par un mécanisme de rappel). Si le paramètre hr est S_OK, le gestionnaire de ressources suppose que la ressource est maintenant détenue par l’appelant. Si le paramètre hr est autre que S_OK, le gestionnaire de ressources suppose que la tentative d’acquisition de la ressource a échoué et réaffecte la ressource ailleurs.

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