IDWriteFontDownloadQueue::BeginDownload method

Begins an asynchronous download operation. The download operation executes in the background until it completes or is cancelled by a CancelDownload call.

Syntax


virtual HRESULT BeginDownload(
  [in, optional] IUnknown *context = nullptr
) = 0;

Parameters

context [in, optional]

Type: IUnknown*

Optional context object that is passed back to the download notification handler's DownloadCompleted method. If the context object implements IDWriteFontDownloadListener, its DownloadCompleted will be called when done.

Return value

Type: HRESULT

Returns S_OK if a download was successfully begun, S_FALSE if the queue was empty, or a standard HRESULT error code.

Remarks

BeginDownload removes all download requests from the queue, transferring them to a background download operation. If any previous downloads are still ongoing when BeginDownload is called again, the new download does not complete until the previous downloads have finished.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Header

Dwrite_3.h

Library

Dwrite.lib

DLL

Dwrite.dll

See also

IDWriteFontDownloadQueue

 

 

Show: