Compartir a través de

Método IDWriteFontFace::GetFiles (dwrite.h)

  • Artículo

Obtiene los archivos de fuente que representan una cara de fuente.

Sintaxis

HRESULT GetFiles(
  [in, out]       UINT32          *numberOfFiles,
  [out, optional] IDWriteFontFile **fontFiles
);

Parámetros

[in, out] numberOfFiles

Tipo: UINT32*

Si fontFiles es NULL, recibe el número de archivos que representan la cara de fuente. De lo contrario, se debe pasar el número de archivos de fuente solicitados. Para obtener más información, vea la sección Comentarios, más adelante.

[out, optional] fontFiles

Tipo: IDWriteFontFile**

Cuando este método vuelve, contiene un puntero a una matriz proporcionada por el usuario que almacena punteros a archivos de fuente que representan la cara de fuente. Este parámetro puede ser NULL si el usuario solo quiere el número de archivos que representan la cara de fuente. Esta API incrementa el recuento de referencias de los punteros de archivo de fuente devueltos según las convenciones COM y el cliente debe liberarlos cuando termine.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se debe llamar al método IDWriteFontFace::GetFiles dos veces. La primera vez que llame a GetFilesfontFiles debe ser NULL. Cuando el método devuelve, numberOfFiles recibe el número de archivos de fuente que representan la cara de fuente.

A continuación, llame al método una segunda vez, pasando el valor numberOfFiles que se produjo la primera llamada y un búfer no NULL del tamaño correcto para almacenar los punteros IDWriteFontFile .

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dwrite.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteFontFace