Metodo IAMExtDevice::Calibrate (strmif.h)

Articolo
03/05/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il Calibrate metodo calibra il meccanismo di trasporto di un dispositivo esterno.

Questo metodo non è implementato.

Sintassi

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

Parametri

[in] hEvent

Handle per un evento. L'evento viene segnalato al termine dell'azione.

[in] Mode

Specifica un valore che attiva o disattiva il processo di calibrazione:

Valore	Descrizione
ED_ACTIVE	Attiva il processo di calibrazione.
ED_INACTIVE	Disattiva il processo di calibrazione.
NULL	Nessuna azione; restituire lo stato di calibrazione in pStatus.

[out] pStatus

Puntatore a un intero lungo che riceve uno dei valori seguenti:

Valore	Descrizione
OATRUE	La calibrazione è attiva.
OAFALSE	La calibrazione è inattiva.

Valore restituito

Quando questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Usare questo metodo su determinati dispositivi esterni che richiedono la calibrazione; ad esempio, riavvolgendo un nastro e reimpostando il contatore o calcolando l'offset del frame per un lettore di codice temporale.

I filtri per vari dispositivi esterni possono implementare questo metodo in modo diverso, a seconda della calibrazione necessaria dal dispositivo. Questo metodo presuppone che l'interfaccia IMediaEventSink abbia già stabilito un sink di eventi o che sia stato stabilito un altro metodo di segnalazione eventi.

Implementazione DV

I driver MSDV e UVC non supportano questo metodo. Il metodo restituisce E_NOTIMPL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IAMExtDevice

Condividi tramite