Provides factory methods to construct WinRT-compatible representations of asynchronous operations.
The factory methods take as inputs functions (delegates) that provide managed Task objects;
Different factory methods return different sub-interfaces of Windows.Foundation.IAyncInfo.
When an asynchronous operation created by this factory is actually started (by calling Start()),
the specified Task-provider delegate will be invoked to create the Task that will
be wrapped by the to-WinRT adapter.
Cancel
mechanism exposed by the created asynchronous action and the cancellation of your task.CancellationToken if your task does not support cancellation.
Cancel mechanism of the created asynchronous action and the cancellation of your task,
and (2) hook-up the Progress update delegate exposed by the created async action and the progress updates
published by your task.CancellationToken if your task does not support cancellation.
It is also passed a IProgress if your task does not support progress reporting.
Cancel
mechanism exposed by the created asynchronous operation and the cancellation of your task.CancellationToken if your task does not support cancellation.
Cancel mechanism of the created asynchronous operation and the cancellation of your task,
and (2) hook-up the Progress update delegate exposed by the created async operation and the progress
updates published by your task.CancellationToken if your task does not support cancellation.
It is also passed a IProgress if your task does not support progress reporting.
Windows.Foundation.IBuffer.
source to destination starting at offset 0.
This method does NOT update destination.Length.
count bytes from source starting at offset sourceIndex
to destination starting at destinationIndex.
This method does NOT update destination.Length.
source to destination starting at offset 0.
This method does NOT update destination.Length.
count bytes from source starting at offset sourceIndex
to destination starting at destinationIndex.
This method does NOT update destination.Length.
IBuffer is backed by a managed array, this method will return true and
set underlyingDataArray to refer to that array
and underlyingDataArrayStartOffset to the value at which the buffer data begins in that array.
If the specified IBuffer is not backed by a managed array, this method will return false.
This method is required by managed APIs that wish to use the buffer's data with other managed APIs that use
arrays without a need for a memory copy.
IBuffer.
Will be set to the data array backing buffer or to null.
Will be set to the start offset of the buffer data in the backing array
or to -1.
IBuffer is backed by a managed byte array.IBuffer instances is actually the same memory.
When applied to IBuffer instances backed by managed arrays this method is preferable to a naive comparison
(such as ((IBufferByteAccess) buffer).Buffer == ((IBufferByteAccess) otherBuffer).Buffer) because it avoids
pinning the backing array which would be necessary if a direct memory pointer was obtained.
IBuffer instance.
An IBuffer instance or null.
true if the underlying Buffer memory pointer is the same for both specified
IBuffer instances (i.e. if they are backed by the same memory); false otherwise.IBuffer instance backed by the same memory as is backing the specified MemoryStream.
The MemoryStream may re-sized in future, as a result the stream will be backed by a different memory region.
In such case, the buffer created by this method will remain backed by the memory behind the stream at the time the buffer was created.ObjectDisposedException if the specified stream is closed.UnauthorizedAccessException if the specified stream cannot expose its underlying memory buffer.
IBuffer backed by the same memory as this specified stream.IBuffer instance backed by the same memory as is backing the specified MemoryStream.
The MemoryStream may re-sized in future, as a result the stream will be backed by a different memory region.
In such case buffer created by this method will remain backed by the memory behind the stream at the time the buffer was created.ObjectDisposedException if the specified stream is closed.UnauthorizedAccessException if the specified stream cannot expose its underlying memory buffer.
The created buffer begins at position positionInStream in the stream and extends over up to length bytes.
If the stream has less than length bytes after the specified starting position, the created buffer covers only as many
bytes as available in the stream. In either case, the Length and the Capacity properties of the created
buffer are set accordingly: Capacity - number of bytes between positionInStream and the stream capacity end,
but not more than length; Length - number of bytes between positionInStream and the stream
length end, or zero if positionInStream is beyond stream length end, but not more than length.
IBuffer backed by the same memory as this specified stream.AsyncInfoIdGenerator.InvalidId.
id to a unique Id-value that can be used for an IAsyncInfo object under the
assumption that another thread may also attempt to initialise id. The thread that changes id
first from AsyncInfoIdGenerator.InvalidId to another value wins and all other threads will respect that
choice and leave id unchanged. The method returns the Id that was agreed upon by the race.
System.Threading.Tasks.Task objects as
through the WinRT Windows.Foundation.IAsyncInfo interface.
ErrorCode
property is accessed several times. null indicates either no error or that ErrorCode
has not yet been called.underlyingTask.
A progress listener/pugblisher that receives progress notifications
form underlyingTask.
synchronousResult is used as the result value.
default(TResult))
m_state bit field to reflect the specified async state with the corresponding STATE_XXX bit mask.
useCondition is FALSE: this field is ignored.
If useCondition is TRUE: Unless this value has at least one bit with m_state in
common, this method will not perform any action.
If TRUE, use conditionBitMask to determine whether the state should be set;
If FALSE, ignore conditionBitMask.
If useCondition is FALSE: this field is set to FALSE;
If useCondition is TRUE: this field indicated whether the specified conditionBitMask
had at least one bit in common with m_state (TRUE)
or not (FALSE).
(!) Note that the meaning of this parameter to the caller is not quite the same as whether m_state
is/was set to the specified value, because m_state may already have had the specified value, or it
may be set and then immediately changed by another thread. The true meaning of this parameter is whether or not
the specified condition did hold before trying to change the state.
m_state.m_state bit field according to the specified bit-mask parameters.
m_state bit field
Any bits that are OFF in this value will get turned OFF,
unless they are explicitly switched on by newStateSetMask.
If useCondition is FALSE: this field is ignored.
If useCondition is TRUE: Unless this value has at least one bit with m_state in
common, this method will not perform any action.
If TRUE, use conditionBitMask to determine whether the state should be set;
If FALSE, ignore conditionBitMask.
If useCondition is FALSE: this field is set to FALSE;
If useCondition is TRUE: this field indicated whether the specified conditionBitMask
had at least one bit in common with m_state (TRUE)
or not (FALSE).
(!) Note that the meaning of this parameter to the caller is not quite the same as whether m_state
is/was set to the specified value, because m_state may already have had the specified value, or it
may be set and then immediately changed by another thread. The true meaning of this parameter is whether or not
the specified condition did hold before trying to change the state.
m_state.VoidValueTypeParameter when a reference type is required.
In case of an actual instantiation (e.g. through default(T)),
using VoidValueTypeParameter offers better performance.wrapper for a managed stream that implements all WinRT stream operations.
This class must not implement any WinRT stream interfaces directly.
We never create instances of this class directly; instead we use classes defined in
the region Interface adapters to implement WinRT ifaces and create instances of those types.
See comment in that region for technical details.
Stream used to wrap a Windows Runtime stream to expose it as a managed steam.