Metodo IDeviceControl2::SelectAudioStream (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 SelectAudioStream metodo seleziona il flusso audio da riprodurre.

Sintassi

HRESULT SelectAudioStream(
  [in]  ULONG   ulAudio,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parametri

[in] ulAudio

Valore che specifica il flusso audio. I numeri di flusso validi sono da 0 a 7 o DVD_DEFAULT_AUDIO_STREAM per specificare il flusso predefinito.

[in] dwFlags

OR bit per bit di uno o più flag dall'enumerazione DVD_CMD_FLAGS , specificando come sincronizzare il comando. Questo parametro è attualmente ignorato; usare DVD_CMD_FLAG_None.

[out] ppCmd

Riceve un puntatore a un oggetto IOptionCmd che può essere usato per sincronizzare i comandi DVD. Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Per altre informazioni, vedere Sincronizzazione dei comandi DVD.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_FALSE	Non è stato trovato alcun flusso audio predefinito; o dwFlags non è zero.
S_OK	Operazione completata.
E_INVALIDARG	ulAudio non è compreso nell'intervallo o non corrisponde a un flusso audio.
E_UNEXPECTED	Il valore ulAudio è valido, ma il navigatore DVD non è riuscito a impostarlo per qualche motivo.
VFW_E_DVD_OPERATION_INHIBITED	Il controllo UOP impedisce l'operazione.
VFW_E_DVD_STREAM_DISABLED	Il flusso specificato è disabilitato.

Commenti

Questo metodo influisce sull'audio del set di titolo video corrente (VTS). Quando viene chiamato da un menu, questo metodo imposta il flusso audio del titolo da cui è stato chiamato il menu.

Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.

Nome comando J allegato	Domini validi
Audio_Stream_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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 errore e esito positivo

Interfaccia ICollectionControl2

Condividi tramite