Metodo IDebugDataSpaces3::ReadProcessorSystemData (dbgeng.h)

Articolo
08/07/2023

Il metodo ReadProcessorSystemData restituisce 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. Dopo il completamento, 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 del processore (PRCB). 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 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 di questo buffer eseguendo il cast di 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 è stato eseguito correttamente.

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

Commenti

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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite