我是Windows编程的新手,我似乎找不到任何关于理解这个SAL注释含义的资源。我基本上是在尝试寻找示例,以便我确切地知道这对呼叫者和被调用者意味着什么。
这里的 MSDN 文章没有任何帮助。
任何帮助将不胜感激。
"
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
。