Windows SDK和MSDN文檔之間的SAL註釋差異

Question

有人可以在UnmapDebugInformation中解釋此SAL註釋差異嗎？

在MSDN庫documentation，所述debuginfo軟參數被註釋爲在被傳遞：

BOOL WINAPI UnmapDebugInformation(
    _In_ PIMAGE_DEBUG_INFORMATION DebugInfo 
); 

在DbgHelp.h，然而，參數被註釋爲被傳遞出：

BOOL IMAGEAPI UnmapDebugInformation(
    _Out_writes_(_Inexpressible_(unknown)) PIMAGE_DEBUG_INFORMATION DebugInfo 
); 

爲什麼這個參數在SDK中註釋爲_Out_？

（據我所知，這是一個過時的功能;我有興趣瞭解的SDK使用的SAL註釋。）

Answer 1

SAL註釋從MSDN文檔和SDK更新單獨發展。 MSDN文章往往是陳舊的，這很可能曾在SDK中被註釋爲_In_。最早的一個是SDK v6.0，它使用__out_xcount(unknown)。

我認爲通過的結構可能會更新的功能，考慮到它包含一個列表，所以你看到的只是一個更好的版本。它只對代碼分析器很重要。