windows - 了解 __deref_out

Question

我是 Windows 编程新手，似乎找不到任何资源来理解这个 SAL 注释的含义。我基本上是在寻找示例，所以我确切地知道这对调用者和被调用者意味着什么。

这里的 MSDN 文章没有帮助。

任何帮助，将不胜感激。

Answer 1

“deref”表示传入的指针中有一个间接级别。所以而不是：

DWORD Function(BYTE* pBuffer);
// pBuffer is a pointer to a BYTE buffer

你可能有：

DWORD Function(BYTE** ppBuffer);
// pBuffer is a pointer to another pointer
// To access the buffer, dereference the pointer:
// BYTE* pBuffer = *ppBuffer;

"opt" 表示该值是可选的，即ppBuffer可能等于nullptr.