CheckPointer 매크로

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 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).
}

요구 사항

추가 정보

포인터 유효성 검사 매크로