Compartir a través de


Método IDebugRegisters2::SetValues2 (dbgeng.h)

El método SetValues2 establece el valor de varios de los registros de de destino.

Sintaxis

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           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 para los que se van a establecer los valores.

[in, optional] Indices

Especifica una matriz que contiene los índices de los registros para los que se van a establecer 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 establecerán consecutivamente a partir de este índice. De lo contrario, se omite.

[in] Values

Matriz que contiene los valores a los que se van a establecer 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
S_OK
El método se realizó correctamente.

Observaciones

El motor hace lo mejor para convertir los valores en Valores en el tipo de registros; esta conversión es la misma que la realizada por CoerceValue. Si el valor es mayor que el registro puede contener, se quitan los bits menos significativos. Las conversiones de enteros y de punto flotante también se realizarán si es necesario.

Si el valor devuelto no es S_OK, es posible que se hayan establecido algunos de los registros.

Cuando se modifica un hocster, el registro que lo contiene también se modifica.

El método SetValues 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)

Consulte también

IDebugRegisters2

SetValue

SetValues