Méthode IKsFormatSupport ::GetDevicePreferredFormat (devicetopology.h)
La méthode GetDevicePreferredFormat obtient le format de flux audio préféré pour la connexion.
Syntaxe
HRESULT GetDevicePreferredFormat(
[out] PKSDATAFORMAT *ppKsFormat
);
Paramètres
[out] ppKsFormat
Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse d’une mémoire tampon qui contient le spécificateur de format pour le format préféré. Le spécificateur commence par une structure KSDATAFORMAT qui peut être suivie d’informations de format supplémentaires. La méthode alloue le stockage pour le spécificateur de format. L’appelant est responsable de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si la méthode échoue, *ppKsFormat a la valeur NULL. Pour plus d’informations sur KSDATAFORMAT, les spécificateurs de format et CoTaskMemFree, consultez la documentation windows DDK.
Valeur retournée
Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Le pointeur ppKsFormat a la valeur NULL. |
|
Mémoire insuffisante. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | devicetopology.h |