MMIOM_ENDSTREAM
The MMIOM_ENDSTREAM message is sent to a Multimedia I/O (MMIO) procedure to terminate a streaming sequence and deactivate the Quality of Service (QOS) parameters previously allocated for the network or device channel.
Syntax
rc = mmioSendMessage(hmmio, MMIOM_ENDSTREAM, lParam1, lParam2);
Parameters
- pmmioinfo (PMMIOINFO)
- A pointer to an MMIOINFO data structure maintaining the current state of the open file.
- usMsg (USHORT)
- The message identifier, set to `MMIOM_ENDSTREAM`.
- lParam1 (LONG)
- This parameter is not used.
- lParam2 (LONG)
- This parameter is not used.
Return Value
- rc (ULONG)
- Return codes indicating success or the type of failure:
- MMIO_SUCCESS: Streaming mode was successfully deactivated and resources were released.
- MMIOERR_UNSUPPORTED_MESSAGE: The I/O procedure does not support network streaming or does not recognize this message.
- MMIO_ERROR: The teardown request failed due to a device or network error.
Remarks
- **Resource Teardown**: This message acts as the explicit teardown phase for streaming channels. It undoes the resource allocations, buffer locks, and bandwidth reservations that were initialized by a previous MMIOM_BEGINSTREAM request.
- **Documentation Typo Note**: Although the original OS/2 reference text states for `MMIO_SUCCESS` that "The file is in streaming mode", this message explicitly **deactivates** streaming mode. The success code implies that the stream has been cleanly spun down and transitioned back to standard file I/O operations.
- **Network Operations**: Custom I/O procedures interfacing with remote servers or real-time streaming backends implement this hook to release active network sockets, flush remaining data transport frames, and disconnect temporary Quality of Service profiles.