IDebugControl::GetProcessorTypeNames-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetProcessorTypeNames-Methode gibt den vollständigen Namen und den abgekürzten Namen des angegebenen Prozessortyps zurück.

Syntax

HRESULT GetProcessorTypeNames(
  [in]            ULONG  Type,
  [out, optional] PSTR   FullNameBuffer,
  [in]            ULONG  FullNameBufferSize,
  [out, optional] PULONG FullNameSize,
  [out, optional] PSTR   AbbrevNameBuffer,
  [in]            ULONG  AbbrevNameBufferSize,
  [out, optional] PULONG AbbrevNameSize
);

Parameter

[in] Type

Gibt den Typ des Prozessors an, dessen Name angefordert wird. Eine Liste möglicher Werte finden Sie unter GetActualProcessorType .

[out, optional] FullNameBuffer

Empfängt den vollständigen Namen des Prozessortyps. Wenn FullNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] FullNameBufferSize

Gibt die Größe des Puffers in Zeichen an, den FullNameBuffer angibt. Diese Größe enthält den Platz für das "\0"-Endzeichen.

[out, optional] FullNameSize

Empfängt die Größe in Zeichen des vollständigen Namens des Prozessortyps. Diese Größe enthält den Platz für das "\0"-Endzeichen. Wenn FullNameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

[out, optional] AbbrevNameBuffer

Empfängt den abgekürzten Namen des Prozessortyps. Wenn AbbrevNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] AbbrevNameBufferSize

Gibt die Größe des Puffers in Zeichen an, den AbbrevNameBuffer angibt. Diese Größe enthält den Platz für das "\0"-Endzeichen.

[out, optional] AbbrevNameSize

Empfängt die Größe in Zeichen des abgekürzten Namens des Prozessortyps. Diese Größe enthält den Platz für das "\0"-Endzeichen. Wenn AbbrevNameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Mindestens einer von FullNameBuffer oder AbbrevNameBuffer war jedoch für den entsprechenden Namen zu klein, sodass der Name abgeschnitten wurde.