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

Busca la tabla de fuentes OpenType especificada si existe y devuelve un puntero a ella. La función accede a los datos de fuente subyacentes a través de la interfaz de IDWriteFontFileStream implementada por el cargador de archivos de fuente.

Sintaxis

HRESULT TryGetFontTable(
  [in]  UINT32     openTypeTableTag,
  [out] const void **tableData,
  [out] UINT32     *tableSize,
  [out] void       **tableContext,
  [out] BOOL       *exists
);

Parámetros

[in] openTypeTableTag

Tipo: UINT32

Etiqueta de cuatro caracteres de una tabla de fuentes OpenType que se va a buscar. Use la macro DWRITE_MAKE_OPENTYPE_TAG para crearla como UINT32. A diferencia de GDI, no admite las etiquetas TTCF y null especiales para acceder a toda la fuente.

[out] tableData

Tipo: const void**

Cuando este método vuelve, contiene la dirección de un puntero a la base de la tabla en memoria. El puntero solo es válido siempre que la cara de fuente utilizada para obtener la tabla de fuentes todavía existe; (no cualquier otra cara de fuente, incluso si realmente hace referencia a la misma fuente física). Este parámetro se pasa sin inicializar.

[out] tableSize

Tipo: UINT32*

Cuando este método vuelve, contiene un puntero al tamaño, en bytes, de la tabla de fuentes.

[out] tableContext

Tipo: void**

Cuando este método devuelve, la dirección de un puntero al contexto opaco, que debe liberarse llamando a ReleaseFontTable. El contexto procede realmente del IDWriteFontFileStream de nivel inferior, que puede implementar la propia aplicación o DWrite. Es posible que se devuelva un nulltableContext, especialmente si la implementación realiza la asignación de memoria directa en todo el archivo. Sin embargo, siempre la publique más adelante y no la use como prueba para que la función se realice correctamente. La misma tabla se puede consultar varias veces, pero dado que cada contexto devuelto puede ser diferente, debe liberar cada contexto por separado.

[out] exists

Tipo: BOOL*

Cuando este método devuelve, TRUE si existe la tabla de fuentes; De lo contrario, FALSE.

Valor devuelto

Tipo: HRESULT

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

Observaciones

El contexto de la misma etiqueta puede ser diferente para cada llamada, por lo que cada uno debe mantenerse y liberarse por separado.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	dwrite.h
biblioteca de	Dwrite.lib
DLL de	Dwrite.dll

Consulte también

IDWriteFontFace