IDWriteFontFace::GetFiles Method

Obtains the font files representing a font face.

Syntax

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

Parameter

• numberOfFiles [in, out]
  If fontFiles is NULL, receives the number of files representing the font face. Otherwise, the number of font files being requested should be passed. See the Remarks section below for more information.

• fontFiles [out, optional]
  When this method returns, contains a pointer to a user-provided array that stores pointers to font files representing the font face. This parameter can be NULL if the user wants only the number of files representing the font face. This API increments reference count of the font file pointers returned according to COM conventions, and the client should release them when finished.

Rückgabewert

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

Hinweise

The IDWriteFontFace::GetFiles method should be called twice. The first time you call GetFilesfontFiles should be NULL. When the method returns, numberOfFiles receives the number of font files that represent the font face.

Then, call the method a second time, passing the numberOfFiles value that was output the first call, and a non-null buffer of the correct size to store the IDWriteFontFile pointers.

Anforderungen

Siehe auch

IDWriteFontFace