WM_READER_CLIENTINFO structure (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The WM_READER_CLIENTINFO structure describes the client reader (player) accessing the media stream.

Syntax

typedef struct _WMReaderClientInfo {
  DWORD  cbSize;
  WCHAR  *wszLang;
  WCHAR  *wszBrowserUserAgent;
  WCHAR  *wszBrowserWebPage;
  QWORD  qwReserved;
  LPARAM *pReserved;
  WCHAR  *wszHostExe;
  QWORD  qwHostVersion;
  WCHAR  *wszPlayerUserAgent;
} WM_READER_CLIENTINFO;

Members

cbSize

Size of the structure in bytes.

wszLang

Two-letter or three-letter language code.

wszBrowserUserAgent

The browser's user-agent string.

wszBrowserWebPage

Web page that contains the plug-in.

qwReserved

Reserved.

pReserved

Unused. See Remarks.

wszHostExe

Host application's .exe file; for example, Iexplore.exe.

qwHostVersion

Version number of the host application. The value is four unsigned WORD values packed into a 64-bit integer. When the client information is logged, each WORD value is unpacked and translated into its decimal equivalent. For example, if the value is 0x0001000200030004, the version number is logged as "1.2.3.4".

wszPlayerUserAgent

String identifying the player application. For example, "WMPlayer/9.0.0.0" identifies version 9 of the Windows Media Player.

Remarks

In earlier versions of this SDK, the pReserved member was named wszHostUniquePID. The application used this member to specify an ID to send to the server. In the current version, the reader object automatically generates a GUID for the ID, so this structure member is obsolete. It is present only to provide binary compatibility with earlier versions of the SDK.

The GUID generated by the reader object represents a unique user on a particular computer. The reader object stores this value in the registry. If the registry entry does not exist, the SDK dynamically creates it. For more information, see IWMReaderAdvanced2::SetLogClientID.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK
Minimum supported server Windows 2000 Server [desktop apps only]
Header wmsdkidl.h (include Wmsdk.h)

See also

IWMReaderAdvanced::SetClientInfo

Structures