DXGKCB_WRITE_DEVICE_SPACE Rückruffunktion (dispmprt.h)
Die DxgkCbWriteDeviceSpace-Funktion schreibt in einen Gerätekonfigurationsraum 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 einen Anzeigeadapter darstellt. Der Anzeigeminiporttreiber 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 Sie 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 Konfigurationsraum geschrieben werden sollen.
[in] Offset
Der Offset in Bytes in den Konfigurationsraum, an dem die Schreibtransaktion beginnt.
[in] Length
Die Anzahl der zu schreibenden Bytes.
[out] BytesWritten
Ein Zeiger auf eine Variable mit ULONG-Typ, 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 Parameter DeviceHandle, DataType oder Buffer ist ungültig. |
| STATUS_UNSUCCESSFUL | Die Funktion konnte die Daten nicht schreiben. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |