IDebugMemoryBytes2::ReadAtIDebugMemoryBytes2::ReadAt

Lit une séquence d’octets, en commençant à un emplacement donné.Reads a sequence of bytes, starting at a given location.

SyntaxeSyntax

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

ParamètresParameters

pStartContext
[in] Le IDebugMemoryContext2 objet qui spécifie où commencer la lecture des octets.[in] The IDebugMemoryContext2 object that specifies where to start reading bytes.

dwCount
[in] Le nombre d’octets à lire.[in] The number of bytes to read. Indique également la longueur de la rgbMemory tableau.Also specifies the length of the rgbMemory array.

rgbMemory
[dans, out] Tableau remplie avec les octets lus réellement.[in, out] Array filled in with the bytes actually read.

pdwRead
[out] Retourne le nombre d’octets contigus réellement lus.[out] Returns the number of contiguous bytes actually read.

pdwUnreadable
[dans, out] Retourne le nombre d’octets illisibles.[in, out] Returns the number of unreadable bytes. Peut-être une valeur null si le client ne souhaite pas le nombre d’octets illisibles.May be a null value if the client is uninterested in the number of unreadable bytes.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK ; Sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code.

NotesRemarks

Si 100 octets sont demandés et les 50 premières sont lisibles, les 20 suivant sont illisibles, et le 30 restants sont lisibles, cette méthode retourne :If 100 bytes are requested and the first 50 are readable, the next 20 are unreadable, and the remaining 30 are readable, this method returns:

*pdwRead = 50*pdwRead = 50

*pdwUnreadable = 20*pdwUnreadable = 20

Dans ce cas, étant donné que *pdwRead + *pdwUnreadable < dwCount, l’appelant doit effectuer un appel supplémentaire à lire les octets restants 30 des 100 d’origine demandée et le IDebugMemoryContext2 objet passé dans le pStartContext paramètre doit être avancé à 70.In this case, because *pdwRead + *pdwUnreadable < dwCount, the caller must make an additional call to read the remaining 30 bytes of the original 100 requested and the IDebugMemoryContext2 object passed in the pStartContext parameter must be advanced by 70.

Voir aussiSee Also

IDebugMemoryBytes2 IDebugMemoryBytes2
IDebugMemoryContext2IDebugMemoryContext2