windows - 理解 __deref_out

Question

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

MSDN 文章 here没有帮助。

如有任何帮助，我们将不胜感激。

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。