IDebugDataSpaces3::ReadBusData-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadBusData--Methode liest Daten aus einem Systembus.

Syntax

HRESULT ReadBusData(
  [in]            ULONG  BusDataType,
  [in]            ULONG  BusNumber,
  [in]            ULONG  SlotNumber,
  [in]            ULONG  Offset,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG BytesRead
);

Parameter

[in] BusDataType

Gibt den Typ des zu lesenden Busdatentyps an. Ausführliche Informationen zu zulässigen Werten finden Sie in der Dokumentation zur BUS_DATA_TYPE Enumeration im Microsoft Windows SDK.

[in] BusNumber

Gibt die vom System zugewiesene Nummer des Busses an. Dies ist in der Regel null, es sei denn, das System verfügt über mehr als einen Bus desselben Busdatentyps.

[in] SlotNumber

Gibt die logische Steckplatznummer auf dem Bus an.

[in] Offset

Gibt den Offset in den Busdaten an, von dem aus gelesen werden soll.

[out] Buffer

Empfängt die Daten vom Bus.

[in] BufferSize

Gibt die Größe in Byte des Puffers Puffer-an. Dies ist die maximale Anzahl von Bytes, die zurückgegeben werden.

[out, optional] BytesRead

Empfängt die Anzahl der vom Bus gelesenen Bytes. Wenn BytesRead-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

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

Bemerkungen

Diese Methode ist nur im Kernelmodusdebugging verfügbar.

Die Art der aus dem Bus gelesenen Daten ist system-, bus- und steckplatzabhängig.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über