IMFSensorDevice::GetSymbolicLink-Methode (mfidl.h)

Artikel
08/24/2023

Ruft den symbolischen Linknamen des Sensorgeräts ab.

Syntax

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

Parameter

[out] SymbolicLink

Puffer von cchSymbolicLink-Zeichen , in denen der symbolische Linkname geschrieben wird. Der Puffer muss groß genug sein, um den NULL-Abschlussator zu berücksichtigen.

[in] cchSymbolicLink

Anzahl der im SymbolicLink-Puffer verfügbaren Zeichen.

[out] pcchWritten

Ausgabeparameter, der die Anzahl der zeichen enthält, die in SymbolicLink geschrieben wurden. Dies schließt den NULL-Abschlussator ein. Wenn SymbolicLink NULL und cchSymbolicLink 0 ist, enthält pcchWritten die Anzahl von Zeichen, die zum Speichern des symbolischen Linknamens erforderlich sind (einschließlich des NULL-Abschlussators).

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
ERROR_INSUFFICIENT_BUFFER	Der im SymbolicLink-Parameter bereitgestellte Puffer ist nicht groß genug, um den symbolischen Linknamen zu enthalten, einschließlich des NULL-Abschlusszeichens.
MF_E_NOT_INITIALIZED	Das Sensorgerät wurde nicht initialisiert.

Hinweise

Je nach Gerätetyp, der durch ein Element der MFSensorDeviceType-Enumeration definiert wird und durch Aufrufen von GetDeviceType abgerufen werden kann, kann der resultierende symbolische Name ein gültiger symbolischer Gerätename oder eine Anbieter-URL sein. Der Aufrufer sollte nicht versuchen, den Namen zu analysieren, und sollte ihn als undurchsichtige Daten behandeln.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mfidl.h
Bibliothek	Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFSensorDevice