SafeBuffer Clase

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.dll

Source:

SafeBuffer.cs

Proporciona un búfer de memoria controlado que se puede usar para leer y escribir. Los intentos para acceder a la memoria fuera del búfer controlado (agotamientos y saturaciones) provocan excepciones.

public ref class SafeBuffer abstract : Microsoft::Win32::SafeHandles::SafeHandleZeroOrMinusOneIsInvalid

public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid

type SafeBuffer = class
    inherit SafeHandleZeroOrMinusOneIsInvalid

Public MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid

Herencia

Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid

SafeBuffer

Derivado

Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle

Comentarios

Debe llamar al SafeBuffer.Initialize método antes de usar cualquier instancia de SafeBuffer. Para evitar carreras al almacenar una instancia de un SafeBuffer objeto en una variable estática, debe usar uno de los métodos siguientes:

• Cree un bloqueo al publicar .SafeBuffer

• Cree una variable local, inicialice y SafeBuffer, a continuación, asigne a SafeBuffer la variable estática, por ejemplo, mediante el Interlocked.CompareExchange método .

Nota

Las asignaciones de un constructor de clase estática se bloquean implícitamente.

Constructores

SafeBuffer(Boolean)

Crea una nueva instancia de la clase SafeBuffer y especifica si el identificador del búfer se va a liberar de forma segura.

Campos

handle

Especifica el identificador que se va a ajustar. (Heredado de SafeHandle)

Propiedades

ByteLength	Obtiene el tamaño del búfer, en bytes.
IsClosed	Obtiene un valor que indica si el identificador está cerrado. (Heredado de SafeHandle)
IsInvalid	Obtiene un valor que indica si el identificador no es válido. (Heredado de SafeHandleZeroOrMinusOneIsInvalid)

Métodos

AcquirePointer(Byte*)	Obtiene un puntero de un objeto SafeBuffer para un bloque de memoria.
Close()	Marca el identificador para soltar y liberar recursos. (Heredado de SafeHandle)
DangerousAddRef(Boolean)	Aumenta manualmente el recuento de referencias en instancias de SafeHandle. (Heredado de SafeHandle)
DangerousGetHandle()	Devuelve el valor del campo handle. (Heredado de SafeHandle)
DangerousRelease()	Disminuye manualmente el recuento de referencias en una instancia de SafeHandle. (Heredado de SafeHandle)
Dispose()	Libera todos los recursos que utiliza la clase SafeHandle. (Heredado de SafeHandle)
Dispose(Boolean)	Libera los recursos no administrados usados por la clase SafeHandle especificando si se lleva a cabo una operación de eliminación normal. (Heredado de SafeHandle)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize(UInt32, UInt32)	Especifica el tamaño de asignación del búfer de memoria utilizando el número especificado de elementos y tamaño de elemento. Debe llamar a este método antes de usar la instancia de SafeBuffer.
Initialize(UInt64)	Define el tamaño de asignación del área de memoria en bytes. Debe llamar a este método antes de usar la instancia de SafeBuffer.
Initialize<T>(UInt32)	Define el tamaño de asignación del área de memoria especificando el número de tipos de valor. Debe llamar a este método antes de usar la instancia de SafeBuffer.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Read<T>(UInt64)	Lee un tipo de valor de la memoria en el desplazamiento especificado.
ReadArray<T>(UInt64, T[], Int32, Int32)	Lee el número especificado de tipos de valor de la memoria empezando en el desplazamiento y los escribe en una matriz empezando en el índice.
ReadSpan<T>(UInt64, Span<T>)	Lee los tipos de valor de la memoria a partir del desplazamiento y los escribe en un intervalo. El número de tipos de valor que se leerán viene determinado por la longitud del intervalo.
ReleaseHandle()	Cuando se invalida en una clase derivada, ejecuta el código necesario para liberar el identificador. (Heredado de SafeHandle)
ReleasePointer()	Libera un puntero obtenido por el método AcquirePointer(Byte*).
SetHandle(IntPtr)	Establece el identificador en el identificador preexistente. (Heredado de SafeHandle)
SetHandleAsInvalid()	Marca un identificador para indicar que ya no se utiliza. (Heredado de SafeHandle)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Write<T>(UInt64, T)	Escribe un tipo de valor en la memoria en la ubicación dada.
WriteArray<T>(UInt64, T[], Int32, Int32)	Escribe el número especificado de tipos de valor en una ubicación de memoria leyendo bytes a partir de la ubicación especificada en la matriz de entrada.
WriteSpan<T>(UInt64, ReadOnlySpan<T>)	Escribe los tipos de valor de un intervalo de solo lectura en una ubicación de memoria.