SafeBuffer Clase

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

mscorlib.dll

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

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

[System.Security.SecurityCritical]
public abstract class SafeBuffer : Microsoft.Win32.SafeHandles.SafeHandleZeroOrMinusOneIsInvalid

[<System.Security.SecurityCritical>]
type SafeBuffer = class
    inherit SafeHandleZeroOrMinusOneIsInvalid

Public MustInherit Class SafeBuffer
Inherits SafeHandleZeroOrMinusOneIsInvalid

Herencia

Object

CriticalFinalizerObject

SafeHandle

SafeHandleZeroOrMinusOneIsInvalid

SafeBuffer

Derivado

Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle

Atributos

SecurityCriticalAttribute

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 SafeBuffery, a continuación, asigne a SafeBuffer la variable estática, por ejemplo, mediante el Interlocked.CompareExchange método .

Note

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

Constructores

Nombre	Description
SafeBuffer(Boolean)	Crea una nueva instancia de la SafeBuffer clase y especifica si el identificador del búfer se va a liberar de forma confiable.

Campos

Nombre	Description
handle	Especifica el identificador que se va a encapsular. (Heredado de SafeHandle)

Propiedades

Nombre	Description
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

Nombre	Description
AcquirePointer(Byte*)	Obtiene un puntero de un objeto para un SafeBuffer bloque de memoria.
Close()	Marca el identificador para liberar y liberar recursos. (Heredado de SafeHandle)
DangerousAddRef(Boolean)	Incrementa manualmente el contador de referencia en SafeHandle las instancias. (Heredado de SafeHandle)
DangerousGetHandle()	Devuelve el valor del handle campo. (Heredado de SafeHandle)
DangerousRelease()	Reduce manualmente el contador de referencia en una SafeHandle instancia de . (Heredado de SafeHandle)
Dispose()	Libera todos los recursos usados por la SafeHandle clase . (Heredado de SafeHandle)
Dispose(Boolean)	Libera los recursos no administrados utilizados por la SafeHandle clase que especifica si se debe realizar una operación de eliminación normal. (Heredado de SafeHandle)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa 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 mediante el número especificado de elementos y tamaño de elemento. Debe llamar a este método antes de usar la SafeBuffer instancia de .
Initialize(UInt64)	Define el tamaño de asignación de la región de memoria en bytes. Debe llamar a este método antes de usar la SafeBuffer instancia de .
Initialize<T>(UInt32)	Define el tamaño de asignación de la región de memoria especificando el número de tipos de valor. Debe llamar a este método antes de usar la SafeBuffer instancia de .
MemberwiseClone()	Crea una copia superficial del Objectactual. (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 a partir del desplazamiento y los escribe en una matriz que comienza en el índice.
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 AcquirePointer(Byte*) método .
SetHandle(IntPtr)	Establece el identificador en el identificador preexistente especificado. (Heredado de SafeHandle)
SetHandleAsInvalid()	Marca un identificador como ya no se usa. (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 especificada.
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.