CheckPointer 宏

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

检查指针是否为 NULL。 如果指针为 NULL，则显示宏的函数或方法将返回指定的值。

语法

HRESULT CheckPointer(
    p,
    ret
);

参数

p

指向检查的指针。

Ret

如果 p 为 NULL，则函数或方法返回的值。

返回值

如果 p 为 NULL，则周围函数返回 ret。 否则，宏不会导致周围函数返回。

示例

HRESULT MyFunction(VOID *pSomeParameter)
{
    // Return E_INVALIDARG if pSomeParameter is NULL.
    CheckPointer(pSomeParameter, E_INVALIDARG)

    // Rest of the function (not shown).
}

要求

要求 值
标头
Wxdebug.h (包括 Streams.h)

另请参阅

指针验证宏