MMIOM_ENDINSERT
The MMIOM_ENDINSERT message is sent to a Multimedia I/O (MMIO) procedure to turn off insert mode and restore standard file writing behavior. When received, it signals the I/O procedure that all subsequent `mmioWrite` calls should overwrite existing data at the current file position instead of shifting data downstream to insert it.
Syntax
rc = mmioSendMessage(hmmio, MMIOM_ENDINSERT, 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_ENDINSERT`.
- 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: The I/O procedure successfully transitioned the file out of insert mode and back into overwrite mode.
- MMIO_ERROR: An error occurred, and the file state remains unchanged.
Remarks
- Default State: Overwriting or appending data at the current seek position is the native, default mode of operation for all MMIO procedures.
- Balanced Pairs: This message must be used in a balanced pair following a previous MMIOM_BEGININSERT message request. Failing to send it means the I/O channel will continue processing writes as expansions, unnecessarily shifting target payloads downstream and expanding the file layout.