Metodo IConfigurationInfo2::GetNkaokeAttributes (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetKaraokeAttributes metodo recupera gli attributi karaoke del flusso audio specificato nel titolo o nel menu corrente.

Sintassi

HRESULT GetKaraokeAttributes(
  [in]  ULONG                 ulStream,
  [out] DVD_KaraokeAttributes *pAttributes
);

Parametri

[in] ulStream

Specifica l'indice del flusso audio di cui si desidera eseguire la query sugli attributi. Vedere la sezione Osservazioni.

[out] pAttributes

Puntatore a una struttura DVD_KaraokeAttributes riempita con gli attributi del karaoke.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Argomento non valido.
E_UNEXPECTED	Lo strumento di navigazione DVD non viene inizializzato.
VFW_E_DVD_NOT_IN_KARAOKE_MODE	Il flusso specificato non è in formato karaoke.
VFW_E_DVD_INVALIDDOMAIN	Lo strumento di navigazione DVD non si trova nel dominio del titolo.
VFW_E_DVD_NO_ATTRIBUTES	Gli attributi di karaoke per il flusso specificato non sono disponibili.

Commenti

Questo metodo non restituisce in modo esplicito il numero di canali nel flusso. È possibile ottenere tali informazioni tramite una chiamata a IDeviceInfo2::GetAudioAttributes. Questo metodo viene illustrato nell'applicazione DVDSample in CKarokeDlg::D oModal.

Il parametro ulStream può essere un valore compreso tra 0 e 7 o uno dei seguenti:

Valore	Descrizione
DVD_STREAM_DATA_CURRENT (0x800)	Per eseguire una query sul flusso audio attualmente selezionato.
DVD_DEFAULT_AUDIO_STREAM	Per eseguire una query sul flusso audio predefinito.

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

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia IInfo2

Condividi tramite