Méthode IMFSensorDevice::GetSymbolicLink (mfidl.h)

Article
08/24/2023

Obtient le nom du lien symbolique de l’appareil de capteur.

Syntaxe

HRESULT GetSymbolicLink(
  [out] LPWSTR SymbolicLink,
  [in]  LONG   cchSymbolicLink,
  [out] LONG   *pcchWritten
);

Paramètres

[out] SymbolicLink

Mémoire tampon des caractères cchSymbolicLink où le nom de lien symbolique sera écrit. La mémoire tampon doit être suffisamment grande pour prendre en compte la fin null.

[in] cchSymbolicLink

Nombre de caractères disponibles dans la mémoire tampon SymbolicLink .

[out] pcchWritten

Paramètre de sortie contenant le nombre de caractères écrits dans SymbolicLink. Cela inclut le terminateur null. Si SymbolicLink a la valeur null et que cchSymbolicLink a la valeur 0, pcchWritten contiendra le nombre de caractères nécessaires (y compris la fin null) pour stocker le nom du lien symbolique.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon fournie dans le paramètre SymbolicLink n’est pas assez grande pour contenir le nom du lien symbolique, y compris la terminaison null.
MF_E_NOT_INITIALIZED	L’appareil de capteur n’a pas été initialisé.

Notes

Selon le type d’appareil, qui est défini par un membre de l’énumération MFSensorDeviceType et peut être obtenu en appelant GetDeviceType, le nom symbolique résultant peut être un nom symbolique d’appareil valide ou une URL de fournisseur. L’appelant ne doit pas tenter d’analyser le nom et doit le traiter comme des données opaques.

Spécifications


Client minimal pris en charge	Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfplat.lib; Mfplat.dll

Voir aussi

IMFSensorDevice

Partager via