MicrosoftDocs / feedback

📢 docs.microsoft.com site feedback
https://learn.microsoft.com
Creative Commons Attribution 4.0 International
239 stars 160 forks source link

DirectWrite API documentation error (Dwrite_1.lib / Dwrite_1.dll do not exist) #2798

Open RickDaniels314 opened 4 years ago

RickDaniels314 commented 4 years ago

The "Requirements" section on many DirectWrite API related webpages (and PDF) indicates that library "Dwrite_1.lib" and DLL "Dwrite_1.dll" must be used for various methods, but those two items DO NOT EXIT!

For samples, see webpage:

https://docs.microsoft.com/en-us/windows/win32/api/dwrite_1/nf-dwrite_1-idwritefont1-getunicoderanges

image

and PDF at:

https://opdhsblobprod04.blob.core.windows.net/contents/e949ed40438f454fa1a2b24bbb1abfa9/214f63b41c990103f77061f386afc746?sv=2018-03-28&sr=b&si=ReadPolicy&sig=Gf2HxeDvZA2rTivelr6tQJbRydWyNVckYGNiCh93dVw%3D&st=2020-05-28T15%3A49%3A17Z&se=2020-05-29T15%3A59%3A17Z

Seaching through that DirectWrite API PDF documentation shows that the problem is limited to just "Dwrite_1.lib" and "Dwrite_1.dll - i.e., all other documentation refers correctly to "Dwrite.lib" and "Dwrite.dll". And the problem is limited to the sections in the documentation for the Dwrite_1.h header (on the website, this would start with https://docs.microsoft.com/en-us/windows/win32/api/dwrite_1/) (in the PDF, that is the Dwrite_1.h section).

For background, everything in the DirectWrite API appears to be contained in Dwrite.dll which is pointed to by the Dwrite.lib library. In Visual Studio, only Dwrite.lib needs to be added to the Linker>Input>Additional Dependencies area for the project's properties (i.e., the project does NOT need to overtly specify Dwrite.dll).

Request/Solution

Someone should confirm what the required libraries should be (e.g., Dwrite.lib and Dwrite.dll) and then update the affected webpages and PDF sections.

welcome[bot] commented 4 years ago

Thank you for creating the issue! One of our team members will get back to you shortly with additional information. If this is a product issue, please close this and contact the particular product's support instead (see https://support.microsoft.com/allproducts for the list of support websites).