SMH_NOTIFY Return Value - rc

rc (ULONG)

Return codes indicating success or the type of failure:

NO_ERROR

Message performed.
ERROR_BUFFER_NOT_AVAILABLE
No buffers available for this request. Possible reasons are:

• For multiple-buffer requests, part of the request might have been satisfied. The ulGetNumEntries or ulRetNumEntries fields will contain the number of buffers that were successful.
  
• A stream is pending completion of a destroy or stop request.
  
• The stream is stopped.
  
• End of stream has been reached.
ERROR_TOO_MANY_BUFFERS
For a BUF_GIVE_BUF request, too many buffers have been given to the Sync/Stream Manager. Increase the ulMaxBuf field in the SPCB to be able to specify more buffers.
ERROR_TOO_MANY_RECORDS
For a BUF_RETURNFULL+BUF_RECORDS request, not enough resources are available to handle the complete request. The ulRetNumEntries field will contain the number of entries accepted on the return. The stream handler must block itself and wait for resources. This is similar to the ERROR_BUFFER_NOT_AVAILABLE response.
ERROR_INVALID_FUNCTION
Invalid function requested.
ERROR_INVALID_STREAM
Invalid stream handle.
ERROR_INVALID_HID
Invalid handler ID.
ERROR_INVALID_FLAG
Invalid input flag value.
ERROR_LOCKING_BUFFER
For a BUF_GIVEBUF request, there was a problem locking the buffer. The caller must block until SHC_START is received from the Sync/Stream Manager and then try the request again.
ERROR_UNLOCKING_BUFFER
For a BUF_RETURNEMPTY request, there was a problem unlocking a user-provided buffer.
ERROR_INVALID_BLOCK
Invalid pointer.
ERROR_INVALID_BUFFER_SIZE
Invalid buffer size in a Return Full or Give Buffer request.
ERROR_INVALID_BUFFER_RETURNED
Invalid buffer was returned. This might happen if a stream handler attempts to return the same buffer more than once.
ERROR_INVALID_RECORD_RETURNED
The record returned does not belong to the buffer specified on a Return Full request.
ERROR_STREAM_NOT_OWNER
A source stream handler tried to Get Empty a buffer from a stream that is using the stream's buffers (split streams only).
ERROR_STREAM_NOT_ACTIVE
A stream is pending completion of a destroy or stop request, or the stream is stopped.
ERROR_INVALID_PARAMETER
Invalid parameter.

---

[Back: SMH_NOTIFY Parameter - pParmIn]
[Next: SMH_NOTIFY - Description]