EC_WMT_EVENT (Dshow.h)

[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.]

Sent by the WM ASF Reader filter when it reads ASF files protected by digital rights management (DRM).

Parameters

lParam1

One of the following WMT_STATUS values:

Value Description
WMT_ACQUIRE_LICENSE Sent when the DRM component has completed the license acquisition process, either successfully or unsuccessfully.
WMT_INDIVIDUALIZE The security upgrade process has completed, either successfully or unsuccessfully.
WMT_NEEDS_INDIVIDUALIZATION The file requires that an application receive a security upgrade before performing the requested action.
WMT_NO_RIGHTS The application has no rights to perform he requested action on a file protected by DRM version 1.
WMT_NO_RIGHTS_EX The application has no rights to perform he requested action on a file protected by DRM version 7.

lParam2

Pointer to an AM_WMT_EVENT_DATA structure that contains information about the event, or NULL. The pData member of this structure points to additional data, whose type depends on the value of lParam1, as shown in the following table.

lParam1 AM_WMT_EVENT_DATA.pData
WMT_ACQUIRE_LICENSE Pointer to a WM_GET_LICENSE_DATA structure. This structure is documented in the Windows Media Format SDK.
WMT_INDIVIDUALIZE Pointer to a WM_INDIVIDUALIZE_STATUS structure.
WMT_NEEDS_INDIVIDUALIZATION NULL.
WMT_NO_RIGHTS Pointer to a wide-character string containing a challenge URL.
WMT_NO_RIGHTS_EX Pointer to a WM_GET_LICENSE_DATA structure.

The value of lParam2 might be NULL. Check the value before dereferencing the pointer.

Remarks

See the Windows Media Format SDK documentation for more information on enabling playback of DRM-protected files.

Requirements

Requirement Value
Header
Dshow.h

See also

Event Notification Codes

Event Notification in DirectShow