IDebugMemoryBytes2::ReadAt

Odczytuje sekwencję bajtów, zaczynając od danej lokalizacji.

Składnia

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
);

Parametry

pStartContext
[in] Obiekt IDebugMemoryContext2 , który określa, gdzie rozpocząć odczytywanie bajtów.

dwCount
[in] Liczba bajtów do odczytania. Określa również długość rgbMemory tablicy.

rgbMemory
[in, out] Tablica wypełniona rzeczywiście odczytanymi bajtami.

pdwRead
[out] Zwraca liczbę ciągłych bajtów rzeczywiście odczytanych.

pdwUnreadable
[in, out] Zwraca liczbę nieczytelnych bajtów. Może być wartością null, jeśli klient jest niezainteresowany liczbą nieczytelnych bajtów.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca S_OK; w przeciwnym razie zwraca kod błędu.

Uwagi

Jeśli zażądano 100 bajtów, a pierwsze 50 można odczytać, następne 20 jest nieczytelnych, a pozostałe 30 można odczytać, ta metoda zwraca:

*pdwRead = 50

*pdwUnreadable = 20

W takim przypadku, ponieważ *pdwRead + *pdwUnreadable < dwCountobiekt wywołujący musi wykonać dodatkowe wywołanie w celu odczytania pozostałych 30 bajtów oryginalnego żądania 100, a obiekt IDebugMemoryContext2 przekazany w parametrze pStartContext musi być zaawansowany przez 70.

Zobacz też

• IDebugMemoryBytes2
• IDebugMemoryContext2