Release Notes

These release notes contain important, late-breaking information for Microsoft® Windows NT® Server NetShow™ Services.

Contents

General Information and Issues

System Requirements:
NetShow Server and Administration Tools
Component Recommended for server and admin Minimum for server and admin Minimum for admin only
Processor Intel Pentium/166 megahertz (MHz) or Digital Alpha 1000a 5/300 Intel Pentium/90 MHz Intel Pentium/90 MHz or Digital Alpha 1000a 5/300
Random access memory (RAM) 64 megabytes (MB) 48 MB 32 MB
Network card Ethernet card Ethernet card Ethernet card
Hard disk space 21 MB; 6 MB for system files and 15 MB for installation 21 MB; 6 MB for system files and 15 MB for installation
Software TCP/IP; Microsoft® Internet Explorer version 4.01 or later; Microsoft® Windows NT® Server version 4.0 with Microsoft® Windows NT® Service Pack 4 (SP4) or later TCP/IP; Microsoft Internet Explorer 4.01 or later; Windows NT Server 4.0 with SP4 or later TCP/IP; Microsoft Internet Explorer 4.01 or later; Microsoft® Windows® 95 with DCOM95


NetShow Tools
Component Recommended Minimum
Processor Pentium II/266 megahertz (MHz) or Digital Alpha 533 based on the 21164PC chip. NetShow™ Encoder has been tested on dual- and quad-processor systems. These systems provide more encoding capabilities than a computer with a single processor. Pentium 90 MHz
Memory (RAM) 32 MB 32 MB
Network card Ethernet card Ethernet card
Software TCP/IP; Windows 95 or Windows NT Server 4.0 (or Microsoft® Windows NT® Workstation version 4.0) with SP4 or later (real-time encoding of audio and video up to 320 x 340 x 15 frames per second) TCP/IP; Windows 95 (real-time encoding of audio only)
Audio Card Creative Labs Soundblaster AWE-64 gold A sound card compatible with Creative Labs Sound Blaster 16
Video Capture Card A video capture card that supports Video for Windows. See the Supported Video Capture Cards table. A video capture card that supports Video for Windows. See the Supported Video Capture Cards table.


Supported Video Capture Cards
Manufacturer Video capture card Operating system
Multimedia Access Corporation Osprey 100 Windows 95, Windows NT 4.0 (x86 or Alpha)
ATI Technologies, Inc. ATI All-in-Wonder Windows 95
Hauppage Computer Works Hauppauge WinCast/TV Windows 95, Windows NT 4.0
Intel Corporation Intel SmartRecorder III Windows 95
Winnov Winnov Videum Windows 95, Windows NT 4.0
Winnov Winnov VideumCam PCMCIA Windows 95, Windows NT 4.0
Toshiba Noteworthy Videophone PCMCIA Windows 95
Digital Vision Digital Vision Computer Eyes/PCI Windows 95, Windows NT 4.0


NetShow Services Clients
Component Recommended Minimum for Microsoft® Windows® Media Player on Windows 95
Processor Intel Pentium/120 MHz; Digital Alpha 1000a 5/300 Pentium 90 MHz
Color display card 256-color display or better 16-color display
Memory (RAM) 64 MB or more 16 MB
Network card 56 kilobits per second (Kbps) or ISDN modem card or Ethernet card 28.8 Kbps modem card (optional for playback)
Sound card Sound Blaster 16 compatible sound card (x86); sound card supported under the Windows NT operating system (alpha) 16-bit sound card
Software Windows 95; Windows NT Server or Windows NT Workstation 4.0 with SP4 (audio, illustrated audio, and video) Windows 95 (audio, illustrated audio, and some video)


NetShow Services Documentation

Complete NetShow Services documentation is installed with NetShow™ server components in Microsoft® Windows NT® Server and Administration Setup. The online NetShow™ tools documentation is installed with NetShow Tools Setup. After you run Setup, you can reach the online documentation from the Microsoft® Windows® Start menu.

NetShow Services documentation for the NetShow server components and NetShow tools is provided in HTML Help which requires Internet Explorer 4.01 or later.  

NetShow Services documentation is installed in the Program files\NetShow Services\docs\html folder. You can open the documentation from there in one of the following ways:

  • If you installed NetShow server components, open NetShow.chm. This single, compressed HTML Help file contains the entire documentation set.
  • If you installed NetShow tools, open nstools.chm.

Return to Contents

Upgrading from Earlier Versions of NetShow Services

  • IMPORTANT: You are strongly advised to run the new command-line utility, ASFCheck.exe, on all your version 2.0 content files (.asf files) after you have backed up that content. ASFCheck.exe is an .asf file verification utility that detects and fixes problems in the file. However, because ASFCheck.exe alters the original .asf file, you must back up your files before running the utility.
  • If you want to keep all settings, including your stations, programs, streams, and publishing points, do not uninstall your earlier version. Instead, install NetShow Services over the earlier version. Also, all directory data and registry information is preserved. After you install NetShow Services, you must restart the computer. If you do not restart the computer, your server configuration will not be migrated.
  • In the NetShow Services, RTP Audio is no longer supported. Any RTP stream is deleted.
  • In the NetShow Services, File Transfer Service (FTS) and Advanced Streaming Format (ASF) streams cannot coexist in a program. These streams must exist in distinct programs. For more information on each of these streams, see NetShow™ Administrator documentation. Any existing program (from version 2.0) that combines FTS and ASF streams is split into separate programs, one program for the FTS stream and one for the ASF stream.
  • You can forcibly upgrade NetShow Services clients from Microsoft® NetShow™ Player version 2.0 to Microsoft Windows Media Player. During installation, an .asf file, fupgrade.asf, is placed in the ASF content root directory (by default, C:\asfroot). Whenever any earlier version of NetShow Player or Windows Media Player connects to any publishing point, instead of streaming the requested stream, the ASF streams upgrade.asf to that client. This .asf file explains to users that they must upgrade their client. The .asf file also contains a script command that opens users' browsers, and goes to a Microsoft Web site where they can download the latest client.

NetShow™ Services Version 1.0 .asf Files

It is a known issue that some version 1.0 .asf files cannot be streamed using NetShow Services. To stream this content, you must regenerate the NetShow Services .asf files from their original sources.

Return to Contents

NetShow Server Components

Events Not Shown on the NetShow™ Server Unicast Monitor

The NetShow Unicast Monitor window (Monitor Server - Publishing Point Clients) does not receive events.

Logging Multicast and Unicast Client Information When Using Netscape Navigator

It is a known issue that Netscape Navigator 3.04 can fail to obtain the URL of the Web page where the client is embedded. This prevents the client information, that is, the URL value of the cs(Refere) field, from being properly logged when Netscape Navigator 3.04 is used on the client side.

NSISAPI Does Not Work

NSISAPI.exe is correctly installed during NetShow server components setup; however, the stand-alone setup does not work correctly on all computers.

Using NetShow Server Components and Microsoft® Site Server with Membership Authorization Plug-In

If you are using NetShow server components with Microsoft® Site Server version 3.0, and you have the Site Server Membership Authorization Plug-in enabled, there is a known "boot race" problem. The Membership Authorization Plug-in fails to load when the NetShow server starts, and clients are unable to connect to the NetShow server.

When this occurs, there is no error message written to the Event Log to indicate a failure. To verify the failure, connect to the NetShow server using NetShow™ Administrator. NetShow Administrator messages appear, indicating that the plug-in has failed to start, and you are prompted to restart the NetShow Unicast service.

To work around this problem, restart the NetShow Unicast service.

Return to Contents

NetShow Encoder

Making NetShow Services ASF Content Compatible with NetShow™ Player Version 2.0

To make sure that content you create with NetShow tools is compatible with the version 2.0 player, use the following steps:

  1. Use NetShow™ Encoder version 2.0 configuration (.asd) files to create content. This method ensures that the content is in the correct format.

  2. When creating content with NetShow tools, use version 2.0-supported codecs:

    Microsoft MPEG-4 Video Codec V1
    Microsoft MPEG-3 Audio Codec
    VoxWare Audio File Codecs - AC8, AC10, AC16

  3. Create .asx files using version 2.0 syntax. For example:

    [Reference]
    Ref1=mms://Dancing/Tango.asf
    BaseURL=http://Image_server/24-bit_color/demo1

Encoding Platform Localization Causes Problems for Lernout & Hauspie Audio Codec

When using NetShow Encoder to create .asd files, care must be taken in localizing the encoding platform. If a localization applet is used to change character definitions and an .asd file is saved on that computer, do not transfer the .asd file to a non-localized computer without first changing the character definitions back to the default values and re-saving the .asd file. If this is not done and the Lernout & Hauspie audio codec is used, the non-localized computer is not able to recognize the codec, and an error occurs.

Enabling Microsoft® PowerPoint® Presenter Browser Identification

Active Server Pages (ASP) use the Browser Capabilities Component to determine which browsers are requesting the ASP. Microsoft maintains up-to-date browscap.ini files that you can use to identify browsers. The current browscap.ini file can be downloaded from the Microsoft® BackOffice® page of the Microsoft® Web site (http://backoffice.microsoft.com/downtrial/moreinfo/bcf.asp).

A working version of the BrowsCap.ini file that is constantly updated can be downloaded from the Cyscape Web site (http://www.cyscape.com/asp/browscap/).

Using NetShow Encoder Automatic Indexing

If you are encoding content to both an .asf file and a NetShow server, and using automatic indexing, do not move the .asf file prior to stopping the encoder. The index is created for the .asf file when the encoding process stops. If you have set a limit on the file size or duration of the .asf file, encoding of the .asf file could be completed prior to the end of the encoding session. If the .asf file is not in the folder in which NetShow Encoder created it, the indexing process fails, and produces an error message.

Creating .asf File without Automatic Indexing

If automatic indexing is not selected when you record an .asf file to disk (defaults to selected), the file, when played locally, plays only once if Repeat forever is selected on the player. You correct this by running NetShow ASF Indexer on the .asf file.

Using Winnov Videum Video Card as the Audio Source

A problem has been encountered with the Winnov 2.0 drivers where the encoding process can fail after a variable amount of time when sourcing audio data from the Winnov Videum card. Winnov currently has new drivers that are being beta-tested. In some cases, installation of the new beta Winnov drivers fixes the problem. Currently, Microsoft recommends that an alternate audio source, such as a sound card, be used instead of the Videum card. There is no problem accepting video data from the Videum card.

Using NetShow Encoder with the Crystal Semiconductor Audio Card

Certain older drivers for the Crystal Semiconductor Audio Cards are not compatible with NetShow Encoder. If you try to use one of these cards, an error message is displayed that reads, "There are no active audio mixer devices available. You may install or activate mixer devices from the Control Panel." An updated version of the driver is available from the Cirrus Logic Web site (http://www.cirrus.com).

Also, when viewing the summary settings on NetShow Encoder when using this audio card, the Audio Input field remains blank, although the audio input is being received and encoded. This is a known issue that is related to the drivers, but has not yet been resolved.

In addition, for Windows 95-based systems, it is recommended that you not use the Crystal Sound CS4232/36/37/38 cards/drivers with NetShow Encoder.

Image Size Constraints When Using NetShow Encoder with Windows 95

Most video capture cards do not support the 720 x 720 image size when you are using NetShow Encoder with Windows 95, and at 100 Kbps, NetShow Encoder can fail.

Latest Hauppauge Wincast/TV NT Drivers (Version 1.06)

If NetShow Encoder tries to open a video capture device that is already in use, the error message, "All boards in use by another process," is displayed many times in a row before finally being cleared. This is a known problem with the latest Hauppauge Wincast/TV NT drivers (version 1.06), and there is no resolution yet.

Another problem has been found where selecting Video Capture in NetShow Encoder sometimes fails to bring up the Wincast capture card properties page. To download any Wincast/TV driver or WinTV application updates that may resolve this problem or the earlier problem, see the Hauppauge Web site (http://wwpreviousw.hauppauge.com).

Certain Voxware Audio Codecs Are Not Appropriate for Real-Time Encoding

Due to the high CPU requirements of the 44 kilohertz (KHz) Voxware MetaSound codecs, these formats have been found not appropriate for real-time encoding when the input is live or when the output is being sent to a NetShow server. There is no associated problem with transcoding file to file, for example from .wav to .asf.

Memory Leak When Using Run-Length Encoding (RLE)

When running Windows 95 and encoding from an .avi file that has run-length encoding (RLE), a memory leak occurs. This is a known issue with Windows 95, and has not been resolved yet.

Audio Loss Setting on NetShow Encoder

If you are going to encode audio-only content for any multicasts or for unicasts that are streamed to substantial numbers of version 2.0 clients, you must use the custom configuration, and you must change the Audio Loss setting from Voice to Music. To change the Audio Loss setting, in NetShow Encoder, go to Properties/Compression, under Audio, select Advanced, and then select Music.

Creating Illustrated Audio with NetShow T.A.G. Author

Currently it is assumed that, when using NetShow™ T.A.G.™ Author, a presentation ends with the last image placed on the timeline. If you have audio content or script commands placed after the last image, this content is not included in the .asf file. To avoid this, make sure that a closing image is placed at the end of your timeline, after all of the content that you want to include in the .asf file.

Using IBM ThinkPad with Trident Video Capture Driver Version 1.11 and IBM Mwave Audio Mixer Is Restricted

When using this encoding platform, you must adhere to the following restrictions for a successful encoding session:

  • Do not use the Duck TrueMotion RT 2.0 video codec.
  • Pixel Format field must be TY2N.
  • From ThinkPad, using Mwave Audio Mixer applet, select "Line/CD" as Input Source for PLAY control screen.
  • Do not use a passive microphone for audio input; use a line in or active (powered) microphone.

VYU9 Pixel Format Does Not Always Work with Brooktree Capture Hardware

There are some scenarios where changing the pixel format to VYU9 causes encoding failure on capture cards that use the Brooktree capture hardware (cards of this type include the Osprey 100 and Wincast cards). If you experience problems with this pixel format, either select the default pixel format (preferred), or one of the other pixel formats in the list. The VYU9 pixel format can be used successfully if selected while creating the encoder configuration.

Using ASFChop on Files with Scripts

ASFChop works differently than documented. The documentation says, "When you use ASFChop on an .asf file, it replaces any existing script commands, indexes, and markers." The script commands are only replaced if another script file is provided to overwrite the existing scripts.

Return to Contents

General HTML Issues

Using Forms in a Web Page to Deliver Content

If you use a form in an HTML document to deliver content to a user (based on user input), you must use the Get method (method = "get") for submission of the form. In this version, if you use the Post method for form submission, the URL returned to the player does not contain the information needed to fully resolve the script processed when the form is submitted.

Return to Contents

ASX Metafiles

ASX Metafile Reference

In this version, if you use Events in an ASX file, the Event must occur in the first Entry (Clip) in the ASX file. If there is not an Event in the first Entry, Events in subsequent Entry elements sometimes do not function correctly.

Return to Contents

Other NetShow Tools

NetShow™ ASF Indexer Fails to Run

It is a known issue that NetShow™ ASF Indexer fails to run if Windows Media Player is not installed on the computer.

Using NetShow ASF Indexer from within Adobe Premiere

When creating .asf files that you want to index from within Adobe Premiere, do not create an .asf file name with embedded spaces. The indexer within Adobe Premiere cannot recognize the file. The stand-alone version of NetShow ASF Indexer can index .asf file that have names with embedded spaces. This issue will be fixed in the released version of the product.

NetShow T.A.G. Author: Conversion Error Can Occur When Converting Audio to Internet 56 Kbps Music

If the message, "1 of 1 files failed to convert with the following error: Unknowns conversion error", appears when using NetShow T.A.G. Author to convert audio to Internet 56 Kbps Music, it means that the audio is precompressed. The solution is to start with audio that is not precompressed.

Return to Contents

Microsoft Windows Media Player

When using certain video display cards with Windows Media Player, such as ATI Rage cards, various redraw problems can occur when a clip is played. The problem can appear as purple or green streaks across the images, as blocks on the images, or as jittery motion. To correct this problem, change the YUV flipping property on the Windows Media Player property pages using the following procedure:

  1. In Windows Media Player, on the File menu, click Properties.
  2. Under Properties, click the Advanced tab.
  3. On the Advanced tab, select Video Renderer from the Filters in use box, and click Properties.
  4. Under Filter Properties, click the DirectDraw tab.
  5. Clear the YUV Flipping check box, click OK, and then close Properties.

Uninstalling Windows Media Player Removes DirectShow Filters

Uninstalling Windows Media Player removes other DirectShow™ filters that are installed on the system. After uninstalling the client, reinstall the application that provides the DirectShow filters.

NetShow Presenter Content viewed with Netscape Navigator

To receive content from NetShow Presenter for Microsoft® PowerPoint® 97, client computers using Netscape Navigator and Windows NT Workstation 4.0 (or Windows NT Server 4.0), you must use Netscape Navigator version 4.05 or later. Otherwise, the content does not play properly with Windows Media Player.

Return to Contents

NetShow Services Software Development Kit (SDK)

Known Issues Using the Windows Media Player Plug-In for Netscape Navigator:

  1. The TransparentAtStart property can exhibit functionality that differs from the Windows Media Player Control implementation.
  2. Netscape Navigator version 3.04 does not support relative paths to content files and URL flips.
  3. The file:/// pathing convention is currently not supported for content files using Netscape Navigator version 3.04.
  4. The caption bar sometimes is not repainted correctly while the presentation is stopped.
  5. When using Netscape Navigator version 4.04 on Windows NT-based computers, a Failure to initialize dddraw.dll error occurs when the plug-in loads a content file. After acknowledging the error, the plug-in functions normally.
  6. Registering the PlayStateChange event under Netscape Navigator 3.04 causes an uncaught Java exception to occur when the play state changes. This exception (known as the 'MAYSCRIPT' error) arises when a call from JavaScript is made into a plug-in, and the call causes an ape Navigator event to be fired immediately. For more information on this bug, see the Microsoft® Windows® Platform section on the Netscape Web site (http://developer.netscape.com/support/bugs/known/index.html)
  7. Some multimedia file MIME types sometimes are not associated with the plug-in during installation.

Note: Property, method, and event names are case-sensitive in JavaScript.

For up-to-date information on the status of the Windows Media Player Plug-in for Netscape Navigator, see the NetShow Services page in the Windows NT Server section of the Microsoft Web site (http://www.microsoft.com/NTserver/Basics/netshowservices/default.asp/site=nts).

Installing SDK Help

NetShow Services Software Development Kit (SDK) documentation is installed as a separate component of NetShow Services. If you choose to install the SDK documentation, you get Help files for the NetShow Services SDK, the Microsoft® NetShow™ Theater Server SDK, and the Microsoft® Windows® Media Player SDK. Each of these SDK components is contained in a separate compiled HTML Help (.chm) file.

The SDK documentation can be printed from within the HTML Help viewer application.

Defining a Default Realm for the Authentication Plug-In

The custom authentication in sample provided in the SDK returns a null string for the defaultRealm in the Initialize function. If you build authentication plugins you should define a defplugault realm for the plug-in. If a null string is returned as the value of the default realm (the defaultRealm parameter), Windows Media Player does not save users' passwords in the password list, meaning users must provide a username and password each time they access content on the NetShow server where this authtication plug-in is enabled. This is true even if a user selects the Save Password option in the password dialog. You must modify the source code and change the value of the defaultRealm parameter from null to any acceptable string (sz) value for the default realm. You should select a value that is unique to avoid conflicts with other servers. The file containing the code you must change is Nsdbauthen.cpp, which is found in the SDK\Sample\Admin\Authentication\DBAuthen directory under where the SDK is installed. This is the code from the Nsdbauthen.cpp file:


	  ///////////////////////////////////////////////////////////////////////////////
	  HRESULT NSDBAuthen::Initialize( INSSServerContext *SvrCtx, DWORD *dwFlags,
                                LPBSTR pbstrDefaultRealm )
{

    //
    // do authentication plugin initialization here...
    //

    HRESULT hr;

    //
    // set for uuencoded data
    //
    *dwFlags = NS_TEXT_WIRE_PROTOCOL;

    //
    // Return the default domain to the server.
    //
    OLECHAR szDefaultRealm[1];
    szDefaultRealm[0] = NULL;
    *pbstrDefaultRealm = SysAllocString( szDefaultRealm );
    if ( NULL == *pbstrDefaultRealm )
    {
        return(E_OUTOFMEMORY);
    }

Event Notification Authorization Context

The NSS_USER_IP_ADDRESS property of the user context holds the user's IP address. It returns a Long value, not a String value as stated in the NetShow Services SDK documentation.

File Transfer Service (FTS) Control

HTML pages using the FTS control to transfer large files (over 50 MB) at high bit rates (over 500 Kbps) must not incorporate procedures that respond to all of the events fired by the control. This is because the rate at which events are fired by the control can exceed the rate at which the browser can process these events. This results in a large backlog of queued events, which can leave the browser in a locked state after the file transfer is complete. The solution is to reduce the transfer rate, or reduce the number of event-handling procedures on the HTML page.

INSSAuthenticator::Initialize Section of Authentication API Reference

The LPBSTR pbstrDefaultRealm parameter is defined in the syntax section, but missing from the remarks section of this topic.

Return to Contents

NetShow Solutions Samples

Problems Using NetShow Network Samples on an Alpha Computer

In the Alpha version of the NetShow Services SDK, the version of the Administrator that is installed is for an x86 computer.

Return to Contents

NetShow Services Customer Feedback

Your reports and suggestions are an integral part of the product development cycle. For more information, see the NetShow Services page in the Microsoft Windows NT Server section of the Microsoft Web site:

http://www.microsoft.com/NTserver/Basics/netshowservices/default.asp/site=nts

Or send your feedback to:

nsreport@microsoft.com

When reporting a problem, include the following information:

  1. Operating system version, NetShow Services version (build), browser version, or versions of other components in use.
  2. Problem summary (a brief description of what you see).
  3. Steps to reproduce the problem. These must be as detailed as possible to help reproduce the problem. When possible, provide exact URLs, and a reference to the source, material, or an example of the content. If the issue is related to the SDK or to development, include code examples to reproduce the symptoms.

Return to Contents

© 1997-1998 Microsoft Corporation. All rights reserved.