IDebugDataSpaces3::ReadBusData-Methode (dbgeng.h)

Artikel
02/23/2024

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 Busdatentyp an, aus dem gelesen werden soll. Ausführliche Informationen zu zulässigen Werten finden Sie in der Dokumentation für die BUS_DATA_TYPE-Enumeration im Microsoft Windows SDK.

[in] BusNumber

Gibt die systemseitig 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 Slotnummer auf dem Bus an.

[in] Offset

Gibt den Offset in den Busdaten an, von dem mit dem Lesen begonnen werden soll.

[out] Buffer

Empfängt die Daten vom Bus.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Byte 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 BytesReadNULL 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 .

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen verfügbar.

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

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Freigeben über