IAMExtDevice ::Calibration, méthode (strmif.h)

Article
07/28/2023

[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 Calibrate méthode étalonne le mécanisme de transport d’un appareil externe.

Cette méthode n’est pas implémentée.

Syntaxe

HRESULT Calibrate(
  [in]  HEVENT hEvent,
  [in]  long   Mode,
  [out] long   *pStatus
);

Paramètres

[in] hEvent

Handle vers un événement. L’événement est signalé lorsque l’action est terminée.

[in] Mode

Spécifie une valeur qui active ou désactive le processus d’étalonnage :

Valeur	Description
ED_ACTIVE	Active le processus d’étalonnage.
ED_INACTIVE	Désactive le processus d’étalonnage.
NULL	Aucune action ; retourne le status d’étalonnage dans pStatus.

[out] pStatus

Pointeur vers un entier long qui reçoit l’une des valeurs suivantes :

Valeur	Description
OATRUE	L’étalonnage est actif.
OAFALSE	L’étalonnage est inactif.

Valeur retournée

Lorsque cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Utilisez cette méthode sur certains appareils externes qui nécessitent un étalonnage ; par exemple, rembobiner une bande et réinitialiser le compteur ou calculer le décalage d’image pour un lecteur de timecode.

Les filtres pour différents appareils externes peuvent implémenter cette méthode différemment, en fonction de l’étalonnage dont l’appareil a besoin. Cette méthode suppose que l’interface IMediaEventSink a déjà établi un récepteur d’événements ou qu’une autre méthode de signalisation d’événements a été établie.

Implémentation de DV

Les pilotes MSDV et UVC ne prennent pas en charge cette méthode. La méthode retourne E_NOTIMPL.

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

IAMExtDevice Interface

Partager via