SMH_NOTIFY - Description

This message notifies the Sync/Stream Manager of a stream buffer request.

pParmIn (PPARM_NOTIFY)

A pointer to a PARM_NOTIFY data structure. The pGetBufTab field points to the SRCBUFTAB data structure. The pRetBufTab field points to the TGTBUFTAB data structure.

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 Return Value - rc]
  [Next: SMH_NOTIFY - Remarks]