DXGKCB_READ_DEVICE_SPACE Rückruffunktion (dispmprt.h)
Die DxgkCbReadDeviceSpace-Funktion liest aus einem Gerätekonfigurationsbereich oder dem Erweiterungs-ROM einer Grafikkarte.
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 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 Lesetransaktion. Dieser Parameter muss einer der folgenden Werte sein, die in Dispmprt.h definiert sind.
DXGK_WHICHSPACE_BRIDGE
Lesen aus dem Konfigurationsbereich des PCI Express-Stammports (PCIe).
DXGK_WHICHSPACE_CONFIG
Lesen aus dem Konfigurationsbereich der Grafikkarte.
DXGK_WHICHSPACE_MCH
Lesen aus dem Konfigurationsraum eines Speichercontrollerhubs, der ein Peer zum übergeordneten Bus des Adapters ist.
DXGK_WHICHSPACE_ROM
Lesen aus dem Erweiterungs-ROM der Grafikkarte.
[in] Buffer
Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die aus dem Konfigurationsbereich oder rom gelesenen Daten empfängt.
[in] Offset
Der Offset in den Konfigurationsraum oder das Erweiterungs-ROM, an dem die Lesetransaktion beginnt.
[in] Length
Die Anzahl der zu lesenden Bytes.
[out] BytesRead
Ein Zeiger auf eine Variable vom Typ ULONG, 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 wurde erfolgreich ausgeführt. |
| STATUS_INVALID_PARAMETER | Der DeviceHandle-, DataType- oder Buffer-Parameter ist ungültig. |
| STATUS_UNSUCCESSFUL | Die Funktion konnte die Daten nicht lesen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |