Metodo IDeviceInfo2::GetCurrentAngle (strmif.h)

Articolo
03/02/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 GetCurrentAngle metodo recupera il numero di angoli disponibili nel blocco di angolo corrente e il numero di angolo attualmente selezionato.

Sintassi

HRESULT GetCurrentAngle(
  [out] ULONG *pulAnglesAvailable,
  [out] ULONG *pulCurrentAngle
);

Parametri

[out] pulAnglesAvailable

Riceve il numero di angoli disponibili. Ci sono fino a nove angoli in un blocco di angolo, numerato da 1 a 9. Se il valore è uguale a 1, il navigatore DVD non è in un blocco angolare.

[out] pulCurrentAngle

Riceve il numero di angolo corrente.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Argomento non valido.
VFW_E_DVD_INVALIDDOMAIN	Lo strumento di navigazione DVD non viene inizializzato o non in un dominio valido.

Commenti

Si noti che gli indici dei pulsanti di angolo e menu sono basati su 1, mentre gli indici di flusso audio e secondario sono basati su 0. Quando lo strumento di navigazione DVD sta per immettere un blocco di angolo, invia all'applicazione una notifica di evento EC_DVD_ANGLES_AVAILABLE con lParam impostata su 1. Le applicazioni in genere chiamano GetCurrentAngle e IDeviceControl2::SelectAngle all'interno del gestore eventi per EC_DVD_ANGLES_AVAILABLE.

Questo metodo è illustrato nell'applicazione DVDSample in CAngleDlg::MakeAngleList.

Requisiti

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