Compartilhar via

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

  • Artigo

Obtém o nome simbólico do link do dispositivo do sensor.

Sintaxe

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

Parâmetros

[out] SymbolicLink

Buffer de caracteres cchSymbolicLink em que o nome do link simbólico será gravado. O buffer deve ser grande o suficiente para considerar o terminador nulo.

[in] cchSymbolicLink

Número de caracteres disponíveis no buffer SymbolicLink .

[out] pcchWritten

Parâmetro de saída que contém o número de caracteres gravados em SymbolicLink. Isso inclui o terminador nulo. Se SymbolicLink for nulo e cchSymbolicLink for 0, pcchWritten conterá o número de caracteres necessários (incluindo o terminador nulo) para armazenar o nome simbólico do link.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
ERROR_INSUFFICIENT_BUFFER
 O buffer fornecido no parâmetro SymbolicLink não é grande o suficiente para conter o nome do link simbólico, incluindo o terminador nulo.
MF_E_NOT_INITIALIZED
 O dispositivo de sensor não foi inicializado.

Comentários

Dependendo do tipo de dispositivo, que é definido por um membro da enumeração MFSensorDeviceType e pode ser obtido chamando GetDeviceType, o nome simbólico resultante pode ser um nome simbólico do dispositivo válido ou uma URL do provedor. O chamador não deve tentar analisar o nome e deve tratá-lo como dados opacos.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfplat.lib; Mfplat.dll

Confira também

IMFSensorDevice