PsGetThreadId-Funktion (ntddk.h)

  • Artikel

Diese Routine gibt den eindeutigen Bezeichner (ID) eines bestimmten Threads zurück.

Syntax

HANDLE PsGetThreadId(
  [in] PETHREAD Thread
);

Parameter

[in] Thread

Ein Zeiger auf eine Executive Thread-Objektstruktur (ETHREAD).

Rückgabewert

Gibt einen HANDLE zurück, der die eindeutige ID des vom Aufrufer bereitgestellten Threads ist.

Hinweise

Ein Treiber kann PsGetThreadId aus verschiedenen Gründen aufrufen:

  • Threadidentifikation: Die von PsGetThreadId zurückgegebene Thread-ID ist systemweit eindeutig, nicht nur innerhalb eines einzelnen Prozesses.

  • Debuggen und Protokollierung: Thread-IDs werden häufig beim Debuggen und Protokollieren verwendet, um die Ausführung des Programms nachzuverfolgen.

Die Thread-ID ist für eine Startsitzung nicht eindeutig. Nachdem ein Thread beendet wurde, kann seine ID wiederverwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Kopfzeile ntddk.h
IRQL <= DISPATCH_LEVEL