Metodo IMFSensorDevice::GetSymbolicLink (mfidl.h)

Ottiene il nome del collegamento simbolico del dispositivo sensore.

Sintassi

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

Parametri

[out] SymbolicLink

Buffer di caratteri cchSymbolicLink in cui verrà scritto il nome del collegamento simbolico. Il buffer deve essere sufficientemente grande da tenere conto del carattere di terminazione Null.

[in] cchSymbolicLink

Numero di caratteri disponibili nel buffer SymbolicLink .

[out] pcchWritten

Parametro di output contenente il numero di caratteri scritti in SymbolicLink. Ciò include il carattere di terminazione Null. Se SymbolicLink è null e cchSymbolicLink è 0, pcchWritten conterrà il numero di caratteri necessari (incluso il carattere di terminazione Null) per archiviare il nome del collegamento simbolico.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

A seconda del tipo di dispositivo, definito da un membro dell'enumerazione MFSensorDeviceType e che può essere ottenuto chiamando GetDeviceType, il nome simbolico risultante può essere un nome simbolico di dispositivo valido o un URL del provider. Il chiamante non deve tentare di analizzare il nome e deve considerarlo come dati opachi.

Requisiti

Vedi anche

IMFSensorDevice