IAMExtDevice ::Calibration, 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 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