Compartilhar via


Método IDWriteFactory::CreateFontFileReference (dwrite.h)

Cria um objeto de referência de arquivo de fonte de um arquivo de fonte local.

Sintaxe

HRESULT CreateFontFileReference(
  [in]           WCHAR const     *filePath,
  [in, optional] FILETIME const  *lastWriteTime,
  [out]          IDWriteFontFile **fontFile
);

Parâmetros

[in] filePath

Tipo: const WCHAR*

Uma matriz de caracteres que contém o caminho de arquivo absoluto para o arquivo de fonte. As operações subsequentes no objeto construído poderão falhar se o filePath fornecido pelo usuário não corresponder a um arquivo válido no disco.

[in, optional] lastWriteTime

Tipo: const FILETIME*

A hora da última modificação do caminho do arquivo de entrada. Se o parâmetro for omitido, a função acessará o arquivo de fonte para obter sua última hora de gravação. Você deve especificar esse valor para evitar o acesso extra ao disco. As operações subsequentes no objeto construído poderão falhar se o usuário fornecido lastWriteTime não corresponder ao arquivo no disco.

[out] fontFile

Tipo: IDWriteFontFile**

Quando esse método retorna, contém um endereço de um ponteiro para o objeto de referência de arquivo de fonte recém-criado ou NULL em caso de falha.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteFactory