Макрос CheckPointer

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Проверяет, имеет ли указатель значение NULL. Если указатель имеет значение NULL, функция или метод, в которых отображается макрос, возвращает указанное значение.

Синтаксис

HRESULT CheckPointer(
    p,
    ret
);

Параметры

p: Указатель на проверка.
Ret: Значение, возвращаемое функцией или методом, если p имеет значение NULL.

Возвращаемое значение

Окружающая функция возвращает ret, если p имеет значение NULL. В противном случае макрос не возвращает окружающую функцию.

Примеры

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)

См. также раздел

Макросы проверки указателя

Поделиться через