IDWriteFontFileStream::ReadFileFragment 메서드(dwrite.h)

글꼴 파일에서 조각을 읽습니다.

구문

HRESULT ReadFileFragment(
  [out] void const **fragmentStart,
        UINT64     fileOffset,
        UINT64     fragmentSize,
  [out] void       **fragmentContext
);

매개 변수

[out] fragmentStart

형식: const void**

이 메서드가 반환되면 글꼴 파일 조각의 시작 부분에 대한 포인터의 주소가 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

fileOffset

형식: UINT64

글꼴 파일의 시작 부분에서 조각의 오프셋(바이트)입니다.

fragmentSize

형식: UINT64

파일 조각의 크기(바이트)입니다.

[out] fragmentContext

형식: void**

이 메서드가 반환될 때 에는 ReleaseFileFragment에 전달할 클라이언트 정의 컨텍스트에 대한 포인터에 대한 포인터의 주소가 포함됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

ReadFileFragment 구현은 요청된 글꼴 파일 조각이 파일 범위 내에 있는지 여부를 검사 합니다. 그렇지 않으면 ReadFileFragment에서 오류를 반환해야 합니다.

DirectWrite 여러 스레드에서 동일한 개체에 대해 IDWriteFontFileStream 메서드를 동시에 호출할 수 있습니다. 따라서 내부 변경 가능한 상태에 의존하는 ReadFileFragment 구현은 여러 스레드에서 이러한 상태에 대한 액세스를 직렬화해야 합니다. 예를 들어 별도의 검색 및 읽기 작업을 사용하여 파일 조각을 읽는 구현은 검색 및 읽기 호출이 포함된 코드 블록을 잠금 또는 중요한 섹션 아래에 배치해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteFontFileStream