C++ _Inout_updates_bytes_ 语法 [重复]

Question

我正在使用 mmeapi.h 库并遇到了函数waveOutUnprepareHeader()，我想知道它的语法是如何工作的。

mmeapi.h

DECLARE_HANDLE(HWAVEIN);
DECLARE_HANDLE(HWAVEOUT);
FAR *LPWAVEHDR;

minwindef.h

typedef unsigned int        UINT;

mmeapi.h

waveOutUnprepareHeader(
    _In_ HWAVEOUT hwo,
    _Inout_updates_bytes_(cbwh) LPWAVEHDR pwh,
    _In_ UINT cbwh
    );

1. _Inout_updates_bytes_(cbwh) 有什么作用？
2. DECLARE_HANDLE 有什么作用？

Answer 1

这些是 Microsoft-specific macros，它们是 SAL 的一部分。

微软有this 来说明这些宏的用途：

SAL 是 Microsoft 源代码注释语言。通过使用源代码注释，您可以明确代码背后的意图。这些注释还使自动化静态分析工具能够更准确地分析您的代码，显着减少误报和漏报。

您会发现它们散布在 Microsoft 自己的头文件中，因此可能他们发现它们有助于检测编码错误。 Visual Studio 有一个使用它们的代码分析工具，请参阅：

https://docs.microsoft.com/en-us/cpp/code-quality/code-analysis-for-c-cpp-overview

DECLARE_HANDLE 的用途描述为here。