IDebugMemoryBytes2::ReadAt

Lee una secuencia de bytes, comenzando en una ubicación determinada.

Sintaxis

C#

int ReadAt(
   IDebugMemoryContext2 pStartContext,
   uint                 dwCount,
   byte[]               rgbMemory,
   out uint             pdwRead,
   ref uint             pdwUnreadable
);

C++

HRESULT ReadAt( 
   IDebugMemoryContext2* pStartContext,
   DWORD                 dwCount,
   BYTE*                 rgbMemory,
   DWORD*                pdwRead,
   DWORD*                pdwUnreadable
);

Parámetros

pStartContext
[in] Objeto IDebugMemoryContext2 que especifica dónde empezar a leer bytes.

dwCount
[in] Número de bytes que se van a leer. También especifica la longitud de la rgbMemory matriz.

rgbMemory
[dentro, fuera] Matriz rellenada con los bytes leídos realmente.

pdwRead
[out] Devuelve el número de bytes contiguos leídos realmente.

pdwUnreadable
[dentro, fuera] Devuelve el número de bytes ilegibles. Puede ser un valor NULL si el cliente no estáinteresado en el número de bytes ilegibles.

Valor devuelto

Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve un código de error.

Comentarios

Si se solicitan 100 bytes y se pueden leer los primeros 50, los 20 siguientes son ilegibles y los 30 restantes son legibles, este método devuelve:

*pdwRead = 50

*pdwUnreadable = 20

En este caso, dado que *pdwRead + *pdwUnreadable < dwCount, el autor de la llamada debe realizar una llamada adicional para leer los 30 bytes restantes de los 100 originales solicitados y el objeto IDebugMemoryContext2 pasado en el pStartContext parámetro debe estar avanzado en 70.

Consulte también

• IDebugMemoryBytes2
• IDebugMemoryContext2