Metodo IDebugDataSpaces::ReadProcessorSystemData (dbgeng.h)

Articolo
02/06/2025

Il metodo ReadProcessorSystemData restituisce i dati relativi al processore specificato.

Sintassi

HRESULT ReadProcessorSystemData(
  [in]            ULONG  Processor,
  [in]            ULONG  Index,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG DataSize
);

Parametri

[in] Processor

Specifica il responsabile del trattamento i cui dati devono essere letti.

[in] Index

Specifica il tipo di dati da leggere. La tabella seguente contiene i valori validi. Al termine dell'operazione, i dati restituiti nel buffer buffer hanno il tipo specificato dalla colonna centrale.

Valore	Descrizione
DEBUG_DATA_KPCR_OFFSET	Restituisce l'indirizzo virtuale dell'area pcR (Processor Control Region) del processore. In questo caso, l'argomento Buffer può essere considerato di tipo PULONG64.
DEBUG_DATA_KPRCB_OFFSET	Restituisce l'indirizzo virtuale del blocco di controllo processore del processore. In questo caso, l'argomento Buffer può essere considerato di tipo PULONG64.
DEBUG_DATA_KTHREAD_OFFSET	Restituisce l'indirizzo virtuale della struttura KTHREAD per il thread di sistema in esecuzione nel processore. In questo caso, l'argomento Buffer può essere considerato di tipo PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Restituisce l'indirizzo virtuale della base delle informazioni di paging di proprietà del sistema operativo o del processore. L'indirizzo e il contenuto in corrispondenza dell'indirizzo sono dipendenti dal processore e dal sistema operativo. In questo caso, l'argomento Buffer può essere considerato di tipo PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Restituisce una descrizione del processore. In questo caso, l'argomento Buffer può essere considerato di tipo PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED	Restituisce la velocità del processore in MHz. Questo potrebbe non funzionare in una sessione specifica. In questo caso, l'argomento Buffer può essere considerato di tipo PULONG.

[out] Buffer

Riceve i dati del responsabile del trattamento. Al termine del metodo, è possibile accedere al contenuto del buffer eseguendo il cast buffer al tipo specificato nella tabella precedente.

[in] BufferSize

Specifica le dimensioni in byte del buffer Buffer. Si tratta del numero massimo di byte che verranno restituiti.

[out, optional] DataSize

Riceve le dimensioni dei dati in byte. Se DataSize è null, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

Questo metodo è disponibile solo nel debug in modalità kernel.

Per informazioni sulle strutture PCR, PRCB e KTHREAD, nonché informazioni sulle tabelle di paging, vedere microsoft Windows Internals di David Solomon e Mark Russinovich.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite