ValidateStringPtrW macro

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Verifies that the calling process has read access to a wide-character string. If not, the macro calls the DbgBreak macro.

Syntax

void ValidateStringPtrW(
   LPCWSTR p
);

Parameters

p

Pointer to a NULL-terminated wide-character string.

Return value

This macro does not return a value.

Remarks

This macro is ignored unless DEBUG, _DEBUG, or VFWROBUST is defined when the DirectShow base-class header file is included. This macro can have a significant performance cost.

Requirements

See also

Pointer Validation Macros