Méthode ISpatialAudioObjectRenderStreamBase ::GetService (spatialaudioclient.h)

Article
03/04/2024

Obtient des services supplémentaires à partir de ISpatialAudioObjectRenderStream.

Syntaxe

HRESULT GetService(
  [in]  REFIID riid,
  [out] void   **service
);

Paramètres

[in] riid

ID d’interface du service demandé. Le client doit définir ce paramètre sur l’une des valeurs REFIID suivantes :

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

Pointeur vers une variable pointeur dans laquelle la méthode écrit l’adresse d’un instance de l’interface demandée. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetService échoue, *ppv a la valeur NULL.

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
E_POINTER	Le paramètre ppv a la valeur NULL.
SPTLAUDCLNT_E_DESTROYED	L’ISpatialAudioClient associé au flux audio spatial a été détruit.
AUDCLNT_E_DEVICE_INVALIDATED	Le périphérique de point de terminaison audio a été débranché, ou le matériel audio ou les ressources matérielles associées ont été reconfigurés, désactivés, supprimés ou autrement indisponibles.
SPTLAUDCLNT_E_INTERNAL	Une erreur interne s'est produite.
AUDCLNT_E_UNSUPPORTED_FORMAT	Le média associé au flux audio spatial utilise un format non pris en charge.

Remarques

La méthode GetService prend en charge les interfaces de service suivantes :

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	spatialaudioclient.h

Voir aussi

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase

Partager via