Método IDebugRegisters2::GetValues2 (dbgeng.h)
El método GetValues2 captura el valor de varios de los registros del destino.
Sintaxis
HRESULT GetValues2(
[in] ULONG Source,
[in] ULONG Count,
[in, optional] PULONG Indices,
[in] ULONG Start,
[out] PDEBUG_VALUE Values
);
Parámetros
[in] Source
Especifica el origen de registro que se va a consultar.
Los valores posibles se enumeran en la tabla siguiente.
| Valor | Registro del origen |
|---|---|
| DEBUG_REGSRC_DEBUGGEE | Captura la información de registro del destino. |
| DEBUG_REGSRC_EXPLICIT | Captura de información de registro del contexto de registro del explícito actual. |
| DEBUG_REGSRC_FRAME |
Captura la información de registro del contexto de registro del ámbito actual.
Nota Desenredado de pila no garantiza una actualización precisa del contexto de registro, por lo que es posible que el contexto de registro del marco de ámbito no sea preciso en todos los casos.
|
[in] Count
Especifica el número de registros cuyos valores se solicitan.
[in, optional] Indices
Especifica una matriz que contiene los índices de los registros desde los que se van a obtener los valores. El número de elementos de esta matriz es Count. Si índices es NULL, se usa start en su lugar.
[in] Start
Si índices es null, los registros se leerán consecutivamente a partir de este índice. De lo contrario, se omite.
[out] Values
Recibe los valores de los registros. El número de elementos que contiene esta matriz es Count. Consulte DEBUG_VALUE para obtener una descripción de este tipo de parámetro.
Valor devuelto
Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte valores HRESULT.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El valor del índice de uno de los registros es mayor que el número de registros en el equipo de destino. Es posible que se hayan obtenido resultados parciales; los registros que no se pudieron leer tendrán el tipo DEBUG_VALUE_INVALID. |
Observaciones
Si el valor devuelto no es S_OK, es posible que algunos de los registros todavía se hayan leído. Si el destino no era accesible, el tipo de valor devuelto es E_UNEXPECTED y Valores no se modifica. De lo contrario, valores contendrá resultados parciales y los registros que no se pudieron leer tendrán DEBUG_VALUE_INVALID de tipo. La ambigüedad en el caso del valor devuelto E_UNEXPECTED se puede evitar estableciendo la memoria de Valores en cero antes de llamar a este método.
El método GetValues realiza la misma tarea que este método, pero siempre usa el destino como origen del registro.
Para obtener información general sobre la interfaz de IDebugRegisters y otros métodos relacionados con el registro, consulte Registers.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include DbgEng.h) |