System.IO.Ports.xml 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>System.IO.Ports</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Threading.Tasks.TaskToApm">
  8. <summary>
  9. Provides support for efficiently using Tasks to implement the APM (Begin/End) pattern.
  10. </summary>
  11. </member>
  12. <member name="M:System.Threading.Tasks.TaskToApm.Begin(System.Threading.Tasks.Task,System.AsyncCallback,System.Object)">
  13. <summary>
  14. Marshals the Task as an IAsyncResult, using the supplied callback and state
  15. to implement the APM pattern.
  16. </summary>
  17. <param name="task">The Task to be marshaled.</param>
  18. <param name="callback">The callback to be invoked upon completion.</param>
  19. <param name="state">The state to be stored in the IAsyncResult.</param>
  20. <returns>An IAsyncResult to represent the task's asynchronous operation.</returns>
  21. </member>
  22. <member name="M:System.Threading.Tasks.TaskToApm.End(System.IAsyncResult)">
  23. <summary>Processes an IAsyncResult returned by Begin.</summary>
  24. <param name="asyncResult">The IAsyncResult to unwrap.</param>
  25. </member>
  26. <member name="M:System.Threading.Tasks.TaskToApm.End``1(System.IAsyncResult)">
  27. <summary>Processes an IAsyncResult returned by Begin.</summary>
  28. <param name="asyncResult">The IAsyncResult to unwrap.</param>
  29. </member>
  30. <member name="M:System.Threading.Tasks.TaskToApm.GetTask(System.IAsyncResult)">
  31. <summary>Gets the task represented by the IAsyncResult.</summary>
  32. </member>
  33. <member name="M:System.Threading.Tasks.TaskToApm.ThrowArgumentException(System.IAsyncResult)">
  34. <summary>Throws an argument exception for the invalid <paramref name="asyncResult"/>.</summary>
  35. </member>
  36. <member name="T:System.Threading.Tasks.TaskToApm.TaskAsyncResult">
  37. <summary>Provides a simple IAsyncResult that wraps a Task.</summary>
  38. <remarks>
  39. We could use the Task as the IAsyncResult if the Task's AsyncState is the same as the object state,
  40. but that's very rare, in particular in a situation where someone cares about allocation, and always
  41. using TaskAsyncResult simplifies things and enables additional optimizations.
  42. </remarks>
  43. </member>
  44. <member name="F:System.Threading.Tasks.TaskToApm.TaskAsyncResult._task">
  45. <summary>The wrapped Task.</summary>
  46. </member>
  47. <member name="F:System.Threading.Tasks.TaskToApm.TaskAsyncResult._callback">
  48. <summary>Callback to invoke when the wrapped task completes.</summary>
  49. </member>
  50. <member name="M:System.Threading.Tasks.TaskToApm.TaskAsyncResult.#ctor(System.Threading.Tasks.Task,System.Object,System.AsyncCallback)">
  51. <summary>Initializes the IAsyncResult with the Task to wrap and the associated object state.</summary>
  52. <param name="task">The Task to wrap.</param>
  53. <param name="state">The new AsyncState value.</param>
  54. <param name="callback">Callback to invoke when the wrapped task completes.</param>
  55. </member>
  56. <member name="M:System.Threading.Tasks.TaskToApm.TaskAsyncResult.InvokeCallback">
  57. <summary>Invokes the callback.</summary>
  58. </member>
  59. <member name="P:System.Threading.Tasks.TaskToApm.TaskAsyncResult.AsyncState">
  60. <summary>Gets a user-defined object that qualifies or contains information about an asynchronous operation.</summary>
  61. </member>
  62. <member name="P:System.Threading.Tasks.TaskToApm.TaskAsyncResult.CompletedSynchronously">
  63. <summary>Gets a value that indicates whether the asynchronous operation completed synchronously.</summary>
  64. <remarks>This is set lazily based on whether the <see cref="F:System.Threading.Tasks.TaskToApm.TaskAsyncResult._task"/> has completed by the time this object is created.</remarks>
  65. </member>
  66. <member name="P:System.Threading.Tasks.TaskToApm.TaskAsyncResult.IsCompleted">
  67. <summary>Gets a value that indicates whether the asynchronous operation has completed.</summary>
  68. </member>
  69. <member name="P:System.Threading.Tasks.TaskToApm.TaskAsyncResult.AsyncWaitHandle">
  70. <summary>Gets a <see cref="T:System.Threading.WaitHandle"/> that is used to wait for an asynchronous operation to complete.</summary>
  71. </member>
  72. <member name="P:System.SR.IO_EOF_ReadBeyondEOF">
  73. <summary>Unable to read beyond the end of the stream.</summary>
  74. </member>
  75. <member name="P:System.SR.BaseStream_Invalid_Not_Open">
  76. <summary>The BaseStream is only available when the port is open.</summary>
  77. </member>
  78. <member name="P:System.SR.PortNameEmpty_String">
  79. <summary>The PortName cannot be empty.</summary>
  80. </member>
  81. <member name="P:System.SR.Port_not_open">
  82. <summary>The port is closed.</summary>
  83. </member>
  84. <member name="P:System.SR.Port_already_open">
  85. <summary>The port is already open.</summary>
  86. </member>
  87. <member name="P:System.SR.Cant_be_set_when_open">
  88. <summary>'{0}' cannot be set while the port is open.</summary>
  89. </member>
  90. <member name="P:System.SR.Max_Baud">
  91. <summary>The maximum baud rate for the device is {0}.</summary>
  92. </member>
  93. <member name="P:System.SR.In_Break_State">
  94. <summary>The port is in the break state and cannot be written to.</summary>
  95. </member>
  96. <member name="P:System.SR.Write_timed_out">
  97. <summary>The write timed out.</summary>
  98. </member>
  99. <member name="P:System.SR.CantSetRtsWithHandshaking">
  100. <summary>RtsEnable cannot be accessed if Handshake is set to RequestToSend or RequestToSendXOnXOff.</summary>
  101. </member>
  102. <member name="P:System.SR.NotSupportedEncoding">
  103. <summary>SerialPort does not support encoding '{0}'. The supported encodings include ASCIIEncoding, UTF8Encoding, UnicodeEncoding, UTF32Encoding, and most single or double byte code pages. For a complete list please see the documentation.</summary>
  104. </member>
  105. <member name="P:System.SR.Arg_InvalidSerialPort">
  106. <summary>The given port name ({0}) does not resolve to a valid serial port.</summary>
  107. </member>
  108. <member name="P:System.SR.Arg_InvalidSerialPortExtended">
  109. <summary>The given port name is invalid. It may be a valid port, but not a serial port.</summary>
  110. </member>
  111. <member name="P:System.SR.Argument_InvalidOffLen">
  112. <summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
  113. </member>
  114. <member name="P:System.SR.ArgumentOutOfRange_Bounds_Lower_Upper">
  115. <summary>Argument must be between {0} and {1}.</summary>
  116. </member>
  117. <member name="P:System.SR.ArgumentOutOfRange_Enum">
  118. <summary>Enum value was out of legal range.</summary>
  119. </member>
  120. <member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNumRequired">
  121. <summary>Non-negative number required.</summary>
  122. </member>
  123. <member name="P:System.SR.ArgumentOutOfRange_NeedPosNum">
  124. <summary>Positive number required.</summary>
  125. </member>
  126. <member name="P:System.SR.ArgumentOutOfRange_Timeout">
  127. <summary>The timeout must be greater than or equal to -1.</summary>
  128. </member>
  129. <member name="P:System.SR.ArgumentOutOfRange_WriteTimeout">
  130. <summary>The timeout must be either a positive number or -1.</summary>
  131. </member>
  132. <member name="P:System.SR.IndexOutOfRange_IORaceCondition">
  133. <summary>Probable I/O race condition detected while copying memory. The I/O package is not thread safe by default. In multithreaded applications, a stream must be accessed in a thread-safe way, such as a thread-safe wrapper returned by TextReader's or TextWriter's ...</summary>
  134. </member>
  135. <member name="P:System.SR.IO_OperationAborted">
  136. <summary>The I/O operation has been aborted because of either a thread exit or an application request.</summary>
  137. </member>
  138. <member name="P:System.SR.NotSupported_UnseekableStream">
  139. <summary>Stream does not support seeking.</summary>
  140. </member>
  141. <member name="P:System.SR.ObjectDisposed_StreamClosed">
  142. <summary>Cannot access a closed stream.</summary>
  143. </member>
  144. <member name="P:System.SR.InvalidNullEmptyArgument">
  145. <summary>Argument {0} cannot be null or zero-length.</summary>
  146. </member>
  147. <member name="P:System.SR.Arg_WrongAsyncResult">
  148. <summary>IAsyncResult object did not come from the corresponding async method on this type.</summary>
  149. </member>
  150. <member name="P:System.SR.InvalidOperation_EndReadCalledMultiple">
  151. <summary>EndRead can only be called once for each asynchronous operation.</summary>
  152. </member>
  153. <member name="P:System.SR.InvalidOperation_EndWriteCalledMultiple">
  154. <summary>EndWrite can only be called once for each asynchronous operation.</summary>
  155. </member>
  156. <member name="P:System.SR.UnauthorizedAccess_IODenied_Port">
  157. <summary>Access to the port '{0}' is denied.</summary>
  158. </member>
  159. <member name="P:System.SR.PlatformNotSupported_IOPorts">
  160. <summary>System.IO.Ports is currently only supported on Windows.</summary>
  161. </member>
  162. <member name="P:System.SR.PlatformNotSupported_SerialPort_GetPortNames">
  163. <summary>Enumeration of serial port names is not supported on the current platform.</summary>
  164. </member>
  165. <member name="P:System.SR.IO_PathTooLong">
  166. <summary>The specified file name or path is too long, or a component of the specified path is too long.</summary>
  167. </member>
  168. <member name="P:System.SR.IO_PathNotFound_NoPathName">
  169. <summary>Could not find a part of the path.</summary>
  170. </member>
  171. <member name="P:System.SR.IO_PathNotFound_Path">
  172. <summary>Could not find a part of the path '{0}'.</summary>
  173. </member>
  174. <member name="P:System.SR.IO_FileNotFound">
  175. <summary>Unable to find the specified file.</summary>
  176. </member>
  177. <member name="P:System.SR.IO_FileNotFound_FileName">
  178. <summary>Could not find file '{0}'.</summary>
  179. </member>
  180. <member name="P:System.SR.UnauthorizedAccess_IODenied_NoPathName">
  181. <summary>Access to the path is denied.</summary>
  182. </member>
  183. <member name="P:System.SR.UnauthorizedAccess_IODenied_Path">
  184. <summary>Access to the path '{0}' is denied.</summary>
  185. </member>
  186. <member name="P:System.SR.IO_PathTooLong_Path">
  187. <summary>The path '{0}' is too long, or a component of the specified path is too long.</summary>
  188. </member>
  189. <member name="P:System.SR.IO_SharingViolation_File">
  190. <summary>The process cannot access the file '{0}' because it is being used by another process.</summary>
  191. </member>
  192. <member name="P:System.SR.IO_SharingViolation_NoFileName">
  193. <summary>The process cannot access the file because it is being used by another process.</summary>
  194. </member>
  195. <member name="P:System.SR.ArgumentOutOfRange_FileLengthTooBig">
  196. <summary>Specified file length was too large for the file system.</summary>
  197. </member>
  198. <member name="P:System.SR.IO_FileExists_Name">
  199. <summary>The file '{0}' already exists.</summary>
  200. </member>
  201. <member name="P:System.SR.IO_AlreadyExists_Name">
  202. <summary>Cannot create '{0}' because a file or directory with the same name already exists.</summary>
  203. </member>
  204. <member name="T:System.Runtime.InteropServices.LibraryImportAttribute">
  205. <summary>
  206. Attribute used to indicate a source generator should create a function for marshalling
  207. arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time.
  208. </summary>
  209. <remarks>
  210. This attribute is meaningless if the source generator associated with it is not enabled.
  211. The current built-in source generator only supports C# and only supplies an implementation when
  212. applied to static, partial, non-generic methods.
  213. </remarks>
  214. </member>
  215. <member name="M:System.Runtime.InteropServices.LibraryImportAttribute.#ctor(System.String)">
  216. <summary>
  217. Initializes a new instance of the <see cref="T:System.Runtime.InteropServices.LibraryImportAttribute"/>.
  218. </summary>
  219. <param name="libraryName">Name of the library containing the import.</param>
  220. </member>
  221. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.LibraryName">
  222. <summary>
  223. Gets the name of the library containing the import.
  224. </summary>
  225. </member>
  226. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.EntryPoint">
  227. <summary>
  228. Gets or sets the name of the entry point to be called.
  229. </summary>
  230. </member>
  231. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling">
  232. <summary>
  233. Gets or sets how to marshal string arguments to the method.
  234. </summary>
  235. <remarks>
  236. If this field is set to a value other than <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />,
  237. <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType" /> must not be specified.
  238. </remarks>
  239. </member>
  240. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType">
  241. <summary>
  242. Gets or sets the <see cref="T:System.Type"/> used to control how string arguments to the method are marshalled.
  243. </summary>
  244. <remarks>
  245. If this field is specified, <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling" /> must not be specified
  246. or must be set to <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />.
  247. </remarks>
  248. </member>
  249. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.SetLastError">
  250. <summary>
  251. Gets or sets whether the callee sets an error (SetLastError on Windows or errno
  252. on other platforms) before returning from the attributed method.
  253. </summary>
  254. </member>
  255. <member name="T:System.Runtime.InteropServices.StringMarshalling">
  256. <summary>
  257. Specifies how strings should be marshalled for generated p/invokes
  258. </summary>
  259. </member>
  260. <member name="F:System.Runtime.InteropServices.StringMarshalling.Custom">
  261. <summary>
  262. Indicates the user is suppling a specific marshaller in <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType"/>.
  263. </summary>
  264. </member>
  265. <member name="F:System.Runtime.InteropServices.StringMarshalling.Utf8">
  266. <summary>
  267. Use the platform-provided UTF-8 marshaller.
  268. </summary>
  269. </member>
  270. <member name="F:System.Runtime.InteropServices.StringMarshalling.Utf16">
  271. <summary>
  272. Use the platform-provided UTF-16 marshaller.
  273. </summary>
  274. </member>
  275. <member name="M:Interop.Serial.Read(System.Runtime.InteropServices.SafeHandle,System.Byte*,System.Int32)">
  276. <summary>
  277. Reads a number of bytes from an open file descriptor into a specified buffer.
  278. </summary>
  279. <param name="fd">The open file descriptor to try to read from</param>
  280. <param name="buffer">The buffer to read info into</param>
  281. <param name="count">The size of the buffer</param>
  282. <returns>
  283. Returns the number of bytes read on success; otherwise, -1 is returned
  284. Note - on fail. the position of the stream may change depending on the platform; consult man 2 read for more info
  285. </returns>
  286. </member>
  287. <member name="M:Interop.Serial.Write(System.Runtime.InteropServices.SafeHandle,System.Byte*,System.Int32)">
  288. <summary>
  289. Writes the specified buffer to the provided open file descriptor
  290. </summary>
  291. <param name="fd">The file descriptor to try and write to</param>
  292. <param name="buffer">The data to attempt to write</param>
  293. <param name="bufferSize">The amount of data to write, in bytes</param>
  294. <returns>
  295. Returns the number of bytes written on success; otherwise, returns -1 and sets errno
  296. </returns>
  297. </member>
  298. <member name="M:Interop.Serial.Poll(Interop.PollEvent*,System.UInt32,System.Int32,System.UInt32*)">
  299. <summary>
  300. Polls a set of file descriptors for signals and returns what signals have been set
  301. </summary>
  302. <param name="pollEvents">A list of PollEvent entries</param>
  303. <param name="eventCount">The number of entries in pollEvents</param>
  304. <param name="timeout">The amount of time to wait; -1 for infinite, 0 for immediate return, and a positive number is the number of milliseconds</param>
  305. <param name="triggered">The number of events triggered (i.e. the number of entries in pollEvents with a non-zero TriggeredEvents). May be zero in the event of a timeout.</param>
  306. <returns>An error or Error.SUCCESS.</returns>
  307. </member>
  308. <member name="M:Interop.Serial.Poll(System.Runtime.InteropServices.SafeHandle,Interop.PollEvents,System.Int32,Interop.PollEvents@)">
  309. <summary>
  310. Polls a File Descriptor for the passed in flags.
  311. </summary>
  312. <param name="fd">The descriptor to poll</param>
  313. <param name="events">The events to poll for</param>
  314. <param name="timeout">The amount of time to wait; -1 for infinite, 0 for immediate return, and a positive number is the number of milliseconds</param>
  315. <param name="triggered">The events that were returned by the poll call. May be PollEvents.POLLNONE in the case of a timeout.</param>
  316. <returns>An error or Error.SUCCESS.</returns>
  317. </member>
  318. <member name="T:Interop.Error">
  319. <summary>Common Unix errno error codes.</summary>
  320. </member>
  321. <member name="M:Interop.CheckIo(System.Int64,System.String,System.Boolean)">
  322. <summary>
  323. Validates the result of system call that returns greater than or equal to 0 on success
  324. and less than 0 on failure, with errno set to the error code.
  325. If the system call failed for any reason, an exception is thrown. Otherwise, the system call succeeded.
  326. </summary>
  327. <param name="result">The result of the system call.</param>
  328. <param name="path">The path with which this error is associated. This may be null.</param>
  329. <param name="isDirError">true if error is caused by a directory issue.</param>
  330. <returns>
  331. On success, returns the non-negative result long that was validated.
  332. </returns>
  333. </member>
  334. <member name="M:Interop.ThrowIOExceptionForLastError">
  335. <summary>
  336. Throws an IOException using the last error info (errno).
  337. </summary>
  338. </member>
  339. <member name="M:Interop.CheckIo(System.Int32,System.String,System.Boolean)">
  340. <summary>
  341. Validates the result of system call that returns greater than or equal to 0 on success
  342. and less than 0 on failure, with errno set to the error code.
  343. If the system call failed for any reason, an exception is thrown. Otherwise, the system call succeeded.
  344. </summary>
  345. <returns>
  346. On success, returns the non-negative result int that was validated.
  347. </returns>
  348. </member>
  349. <member name="M:Interop.CheckIo(System.IntPtr,System.String,System.Boolean)">
  350. <summary>
  351. Validates the result of system call that returns greater than or equal to 0 on success
  352. and less than 0 on failure, with errno set to the error code.
  353. If the system call failed for any reason, an exception is thrown. Otherwise, the system call succeeded.
  354. </summary>
  355. <returns>
  356. On success, returns the non-negative result IntPtr that was validated.
  357. </returns>
  358. </member>
  359. <member name="M:Interop.CheckIo``1(``0,System.String,System.Boolean)">
  360. <summary>
  361. Validates the result of system call that returns greater than or equal to 0 on success
  362. and less than 0 on failure, with errno set to the error code.
  363. If the system call failed for any reason, an exception is thrown. Otherwise, the system call succeeded.
  364. </summary>
  365. <returns>
  366. On success, returns the valid SafeFileHandle that was validated.
  367. </returns>
  368. </member>
  369. <member name="M:Interop.GetExceptionForIoErrno(Interop.ErrorInfo,System.String,System.Boolean)">
  370. <summary>
  371. Gets an Exception to represent the supplied error info.
  372. </summary>
  373. <param name="errorInfo">The error info</param>
  374. <param name="path">The path with which this error is associated. This may be null.</param>
  375. <param name="isDirError">true if error is caused by a directory issue.</param>
  376. <returns></returns>
  377. </member>
  378. </members>
  379. </doc>