IDWriteFactory::CreateCustomFontFileReference Method

Creates a reference to an application-specific font file resource.

Syntax

virtual HRESULT CreateCustomFontFileReference(
  [in]   const void * fontFileReferenceKey,
  UINT32  fontFileReferenceKeySize,
  IDWriteFontFileLoader * fontFileLoader,
  [out]  IDWriteFontFile ** fontFile
) = 0;

Parameter

• fontFileReferenceKey [in]
  A font file reference key that uniquely identifies the font file resource during the lifetime of fontFileLoader.

• fontFileReferenceKeySize
  The size of the font file reference key in bytes.

• fontFileLoader
  The font file loader that will be used by the font system to load data from the file identified by fontFileReferenceKey.

• fontFile [out]
  Contains an address of a pointer to the newly created font file object when this method succeeds, or NULL in case of failure.

Rückgabewert

Ist Methode erfolgreich, wird "S_OK" zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

This function is provided for cases when an application or a document needs to use a private font without having to install it on the system. fontFileReferenceKey has to be unique only in the scope of the fontFileLoader used in this call.

Anforderungen

Siehe auch

IDWriteFactory