IMFSensorDevice::GetSymbolicLink-Methode (mfidl.h)

Ruft den symbolischen Verknüpfungsnamen 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-Terminator zu berücksichtigen.

[in] cchSymbolicLink

Anzahl der Zeichen, die im SymbolischenLink-Puffer verfügbar sind.

[out] pcchWritten

Ausgabeparameter, der die Anzahl der Zeichen enthält, die in SymbolicLink geschrieben wurden. Dies schließt den Null-Endator ein. Wenn "SymbolicLink " null ist und "cchSymbolicLink " 0 ist, enthält "pcchWritten " die Anzahl der benötigten Zeichen (einschließlich des Null-Terminators), um den symbolischen Verknüpfungsnamen zu speichern.

Zurückgegebener Wert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

Je nach Gerätetyp, der durch ein Element der MFSensorDeviceType-Aufzählung 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 als undurchsichtige Daten zu behandeln.

Anforderungen

Siehe auch

IMFSensorDevice