IDWriteFontFace::GetFiles メソッド (dwrite.h)

フォント面を表すフォント ファイルを取得します。

構文

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

パラメーター

[in, out] numberOfFiles

種類: UINT32*

fontFiles が NULL の場合は、フォント面を表すファイルの数を受け取ります。 それ以外の場合は、要求されるフォント ファイルの数を渡す必要があります。 詳細については、以下の「解説」セクションを参照してください。

[out, optional] fontFiles

型: IDWriteFontFile**

このメソッドが戻るときに、 には、フォントの顔を表すフォント ファイルへのポインターを格納する、ユーザー指定の配列へのポインターが含まれます。 ユーザーがフォント面を表すファイルの数のみを必要とする場合、このパラメーターは NULL にすることができます 。 この API では、COM 規則に従って返されるフォント ファイル ポインターの参照カウントがインクリメントされ、クライアントは完了したら解放する必要があります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

IDWriteFontFace::GetFiles メソッドを 2 回呼び出す必要があります。 GetFiles fontFiles を初めて呼び出す場合はNULL にする必要があります。 メソッドから制御が戻ると、 numberOfFiles は フォントの顔を表すフォント ファイルの数を受け取ります。

次に、メソッドを 2 回目に呼び出し、最初の呼び出しを出力した numberOfFiles 値と、 IDWriteFontFile ポインターを格納するための正しいサイズの null 以外のバッファーを渡します。

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	dwrite.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

関連項目

IDWriteFontFace