Metodo IMFSourceReader::SetStreamSelection (mfreadwrite.h)

Articolo
03/15/2023

Seleziona o deseleziona uno o più flussi.

Sintassi

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Parametri

[in] dwStreamIndex

Flusso da impostare. Il valore può essere uno dei seguenti.

Valore	Significato
0-0xFFFFFFFB	Indice in base zero di un flusso.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Primo flusso video.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Primo flusso audio.
MF_SOURCE_READER_ALL_STREAMS 0xFFFFFFFE	Tutti i flussi.

[in] fSelected

Specificare TRUE per selezionare flussi o FALSE per deselezionare i flussi. Se un flusso è deselezionato, non genererà dati.

Valore restituito

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

Commenti

Esistono due usi comuni per questo metodo:

Per modificare la selezione del flusso predefinita. Alcuni file multimediali contengono più flussi dello stesso tipo. Ad esempio, un file può includere flussi audio per più lingue. È possibile usare questo metodo per modificare il flusso selezionato. Per ottenere informazioni su ogni flusso, chiamare IMFSourceReader::GetPresentationAttribute o IMFSourceReader::GetNativeMediaType.
Se non sono necessari dati da uno dei flussi, è consigliabile deselezionare tale flusso. Se il flusso è selezionato, l'origine multimediale potrebbe contenere una coda di dati non letti e la coda potrebbe aumentare indefinitamente, consumando memoria.

Per un esempio di deselezionazione di un flusso, vedere Esercitazione: Decodifica dell'audio.

Se un flusso è deselezionato, il metodo IMFSourceReader::ReadSample restituisce MF_E_INVALIDREQUEST per tale flusso. Altri metodi IMFSourceReader sono validi per i flussi deselezionati.

Stream selezione non influisce sul modo in cui il lettore di origine carica o scarica i decodificatori in memoria. In particolare, la deselezionazione di un flusso non impone al lettore di origine di scaricare il decodificatore per tale flusso.

Questa interfaccia è disponibile in Windows Vista se è installato Platform Update Supplement per Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Supplemento per Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfreadwrite.h

Vedi anche

IMFSourceReader

Lettore di origine

Condividi tramite