DXGKCB_READ_DEVICE_SPACE Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DxgkCbReadDeviceSpace--Funktion liest aus einem Gerätekonfigurationsbereich oder der Erweiterungs-ROM eines Anzeigeadapters.

Syntax

DXGKCB_READ_DEVICE_SPACE DxgkcbReadDeviceSpace;

NTSTATUS DxgkcbReadDeviceSpace(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DataType,
  [in]  PVOID Buffer,
  [in]  ULONG Offset,
  [in]  ULONG Length,
  [out] PULONG BytesRead
)
{...}

Parameter

[in] DeviceHandle

Ein Handle, das einen Anzeigeadapter darstellt. Der Display-Miniporttreiber hat dieses Handle zuvor im DeviceHandle Member der DXGKRNL_INTERFACE Struktur abgerufen, die an DxgkDdiStartDeviceübergeben wurde.

[in] DataType

Der Typ der auszuführenden Lesetransaktion. Dieser Parameter muss einer der folgenden Werte sein, die in Dispmprt.hdefiniert sind.

DXGK_WHICHSPACE_BRIDGE

Lesen Sie den Konfigurationsraum des PCI Express (PCIe)-Stammports.

DXGK_WHICHSPACE_CONFIG

Lesen aus dem Konfigurationsbereich des Grafikkarten.

DXGK_WHICHSPACE_MCH

Lesen Sie aus dem Konfigurationsraum eines Speichercontrollerhubs, der ein Peer zum übergeordneten Bus des Adapters ist.

DXGK_WHICHSPACE_ROM

Lesen Sie aus der Erweiterungs-ROM des Grafikkarten.

[in] Buffer

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Auslesedaten aus dem Konfigurationsraum oder ROM empfängt.

[in] Offset

Der Offset in den Konfigurationsraum oder die Erweiterungs-ROM, bei der die Lesetransaktion beginnt.

[in] Length

Die Anzahl der zu lesenden Bytes.

[out] BytesRead

Ein Zeiger auf eine ULONG-Typvariable, die die Anzahl der tatsächlich gelesenen Bytes empfängt.

Rückgabewert

DxgkCbReadDeviceSpace gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_INVALID_PARAMETER	Der Parameter DeviceHandle, DataType oder Buffer ist ungültig.
STATUS_UNSUCCESSFUL	Die Funktion konnte die Daten nicht lesen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Desktop
Header-	dispmprt.h (include Dispmprt.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

DxgkCbWriteDeviceSpace-

Freigeben über