Share via

IWMSDataContainer.Read (C#)

  • Article

banner art

Previous Next

IWMSDataContainer.Read (C#)

The server calls the Read method to read data from the data container into a buffer.

Syntax

Parameters

pbBuffer

Reference to a byte array identifying the buffer to be filled with data from the data container.

qwOffset

ulong specifying the offset in bytes from which the data should be read. This must be WMS_DATA_CONTAINER_NONSEEKABLE for data containers that do not support seeking. For example, a live source cannot be seekable, but a file can be.

dwMaxDataSize

uint specifying the maximum data size in bytes to be read from the data container.

dwFlags

Reserved for future use.

pCallback

IWMSDataContainerCallback object containing the callback function. The plug-in calls IWMSDataContainerCallback.OnRead to respond to the server.

qwContext

ulong containing a value defined by the server to identify which Read request the plug-in is responding to when it calls IWMSDataContainerCallback.OnRead. The plug-in must pass this value back unaltered.

Return Values

This method does not return a value. To report an error, the plug-in can throw a COMException object to the server. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it throw NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D). Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog object to send custom error information to the Windows Event Viewer, throwing NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about plug-in error information, see Identifying Plug-in Errors.

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next