DXGKCB_WRITE_DEVICE_SPACE Rückruffunktion (dispmprt.h)

  • Artikel

Die DxgkCbWriteDeviceSpace-Funktion schreibt in einen Gerätekonfigurationsbereich oder das Erweiterungs-ROM einer Grafikkarte.

Syntax

DXGKCB_WRITE_DEVICE_SPACE DxgkcbWriteDeviceSpace;

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

Parameter

[in] DeviceHandle

Ein Handle, das eine Grafikkarte darstellt. Der Anzeige-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 Schreibtransaktion. Dieser Parameter muss einer der folgenden Werte sein, die in Dispmprt.h definiert sind:

DXGK_WHICHSPACE_BRIDGE

Schreiben in den Konfigurationsraum des übergeordneten Busgeräts.

DXGK_WHICHSPACE_CONFIG

Schreiben sie in den Konfigurationsraum der Grafikkarte.

DXGK_WHICHSPACE_MCH

Schreiben sie in den Konfigurationsraum eines Speichercontrollerhubs, der ein Peer zum übergeordneten Bus des Adapters ist.

DXGK_WHICHSPACE_ROM

Schreiben sie in das Erweiterungs-ROM der Grafikkarte.

[in] Buffer

Ein Zeiger auf einen Puffer, der die Daten bereitstellt, die in den Konfigurationsbereich geschrieben werden sollen.

[in] Offset

Der Offset in Bytes in den Konfigurationsbereich, an dem die Schreibtransaktion beginnt.

[in] Length

Die Anzahl der zu schreibenden Bytes.

[out] BytesWritten

Ein Zeiger auf eine Variable vom Typ ULONG, die die Anzahl der tatsächlich geschriebenen Bytes empfängt.

Rückgabewert

DxgkCbWriteDeviceSpace gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Funktion wurde erfolgreich ausgeführt.
STATUS_INVALID_PARAMETER Der DeviceHandle-, DataType- oder Buffer-Parameter ist ungültig.
STATUS_UNSUCCESSFUL Die Funktion konnte die Daten nicht schreiben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DxgkCbReadDeviceSpace