Share via

Metodo IMFByteStream::GetCapabilities (mfobjects.h)

  • Articolo

Recupera le caratteristiche del flusso di byte.

Sintassi

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Parametri

[out] pdwCapabilities

Riceve un OR bit per bit pari a zero o più flag. Vengono definiti i flag seguenti.

Valore Significato
MFBYTESTREAM_IS_READABLE
0x00000001
 Il flusso di byte può essere letto.
MFBYTESTREAM_IS_WRITABLE
0x00000002
 Il flusso di byte può essere scritto in .
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 È possibile cercare il flusso di byte.
MFBYTESTREAM_IS_REMOTE
0x00000008
 Il flusso di byte proviene da un'origine remota, ad esempio una rete.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 Il flusso di byte rappresenta una directory di file.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 La ricerca all'interno di questo flusso potrebbe essere lenta. Ad esempio, il flusso di byte potrebbe essere scaricato da una rete.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 Il flusso di byte sta attualmente scaricando i dati in una cache locale. Le operazioni di lettura nel flusso di byte potrebbero richiedere più tempo fino a quando i dati non vengono scaricati completamente.

Questo flag viene cancellato dopo il download di tutti i dati.

Se viene impostato anche il flag MFBYTESTREAM_HAS_SLOW_SEEK , significa che il flusso di byte deve scaricare l'intero file in sequenza. In caso contrario, il flusso di byte può rispondere alle richieste di ricerca riavviando il download da un nuovo punto nel flusso.
MFBYTESTREAM_SHARE_WRITE
0x00000400
 Un altro thread o processo può aprire questo flusso di byte per la scrittura. Se questo flag è presente, la lunghezza del flusso di byte potrebbe cambiare durante la lettura.

Questo flag può influire sul comportamento dei gestori del flusso di byte. Per altre informazioni, vedere MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Nota Richiede Windows 7 o versione successiva.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 Il flusso di byte non usa attualmente la rete per ricevere il contenuto. L'hardware di rete può entrare in uno stato di risparmio energia quando questo bit è impostato.
Nota Richiede Windows 8 o versione successiva.
 

Valore restituito

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

Commenti

Questa interfaccia è disponibile nelle piattaforme seguenti se vengono installati i componenti ridistribuibili di Windows Media Format 11 SDK:

  • Windows XP con Service Pack 2 (SP2) e versioni successive.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione mfobjects.h (include Mfidl.h)
Libreria Mfuuid.lib

Vedi anche

IMFByteStream