Partager via

Méthode IMFByteStream ::GetCapabilities (mfobjects.h)

  • Article

Récupère les caractéristiques du flux d’octets.

Syntaxe

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Paramètres

[out] pdwCapabilities

Reçoit un OR au niveau du bit de zéro ou plusieurs indicateurs. Les indicateurs suivants sont définis.

Valeur Signification
MFBYTESTREAM_IS_READABLE
0x00000001
 Le flux d’octets peut être lu.
MFBYTESTREAM_IS_WRITABLE
0x00000002
 Le flux d’octets peut être écrit dans.
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 Le flux d’octets peut être recherché.
MFBYTESTREAM_IS_REMOTE
0x00000008
 Le flux d’octets provient d’une source distante, telle qu’un réseau.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 Le flux d’octets représente un répertoire de fichiers.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 La recherche dans ce flux peut être lente. Par exemple, le flux d’octets peut être téléchargé à partir d’un réseau.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 Le flux d’octets télécharge actuellement des données dans un cache local. Les opérations de lecture sur le flux d’octets peuvent prendre plus de temps jusqu’au téléchargement complet des données.

Cet indicateur est effacé une fois que toutes les données ont été téléchargées.

Si l’indicateur MFBYTESTREAM_HAS_SLOW_SEEK est également défini, cela signifie que le flux d’octets doit télécharger le fichier entier de manière séquentielle. Sinon, le flux d’octets peut répondre aux demandes de recherche en redémarrant le téléchargement à partir d’un nouveau point dans le flux.
MFBYTESTREAM_SHARE_WRITE
0x00000400
 Un autre thread ou processus peut ouvrir ce flux d’octets pour l’écriture. Si cet indicateur est présent, la longueur du flux d’octets peut changer pendant sa lecture.

Cet indicateur peut affecter le comportement des gestionnaires de flux d’octets. Pour plus d’informations, consultez MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Note Nécessite Windows 7 ou version ultérieure.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 Le flux d’octets n’utilise pas actuellement le réseau pour recevoir le contenu. Le matériel réseau peut passer à un état d’économie d’énergie lorsque ce bit est défini.
Note Nécessite Windows 8 ou une version ultérieure.
 

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette interface est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfobjects.h (include Mfidl.h)
Bibliothèque Mfuuid.lib

Voir aussi

IMFByteStream