Share via

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

  • Article

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