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 메서드를 두 번 호출해야 합니다. GetFiles fontFiles를 처음 호출할 때는 NULL이어야 합니다. 메서드가 반환되면 numberOfFiles 는 글꼴 얼굴을 나타내는 글꼴 파일의 수를 받습니다.

그런 다음 메서드를 두 번째로 호출하여 첫 번째 호출을 출력한 numberOfFiles 값과 올바른 크기의 null이 아닌 버퍼를 전달하여 IDWriteFontFile 포인터를 저장합니다.

요구 사항

참고 항목

IDWriteFontFace