Metodo IMixerPinConfig::GetRelativePosition (mpconfig.h)

Articolo
02/29/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 GetRelativePosition metodo recupera la posizione del flusso nella finestra di visualizzazione.

Sintassi

HRESULT GetRelativePosition(
  [out] DWORD *pdwLeft,
  [out] DWORD *pdwTop,
  [out] DWORD *pdwRight,
  [out] DWORD *pdwBottom
);

Parametri

[out] pdwLeft

Puntatore a un valore che indica la coordinata x nell'angolo superiore sinistro della finestra di visualizzazione.

[out] pdwTop

Puntatore a un valore che indica la coordinata y nell'angolo superiore sinistro della finestra di visualizzazione.

[out] pdwRight

Puntatore a un valore che indica la coordinata x nell'angolo inferiore destro della finestra di visualizzazione.

[out] pdwBottom

Puntatore a un valore che indica la coordinata y nell'angolo inferiore destro della finestra di visualizzazione.

Valore restituito

Restituisce un valore HRESULT . I possibili valori sono i seguenti:

Codice restituito	Descrizione
E_INVALIDARG	Coordinate non nell'intervallo {0, 0, 10.000, 10.000}.
S_OK	Operazione completata.

Commenti

Questo metodo presuppone le coordinate della finestra di {0, 0, 10.000, 10.000}. Se il flusso video viene eseguito il rendering nel quarto inferiore destro della finestra di visualizzazione, questo metodo restituirà {5.000, 5.000, 10.000, 10.000}.

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	mpconfig.h
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IMixerPinConfig

IMixerPinConfig::SetRelativePosition

Condividi tramite