DXGKCB_READ_DEVICE_SPACE回呼函式 (dispmprt.h)

發行項
02/25/2024

DxgkCbReadDeviceSpace 函式會從裝置設定空間或顯示器適配卡的擴充 ROM 讀取。

語法

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
)
{...}

參數

[in] DeviceHandle

表示顯示配接器的句柄。顯示迷你埠驅動程式先前在傳遞至 DxgkDdiStartDevice 之 DXGKRNL_INTERFACE 結構的 DeviceHandle 成員中取得此句柄。

[in] DataType

要執行的讀取交易類型。此參數必須是下列其中一個值，這些值定義於 Dispmprt.h 中。

DXGK_WHICHSPACE_BRIDGE

從PCI Express (PCIe 讀取，) 根埠的設定空間。

DXGK_WHICHSPACE_CONFIG

從顯示配接器的組態空間讀取。

DXGK_WHICHSPACE_MCH

從記憶體控制器中樞的組態空間讀取，該記憶體控制器中樞是與配接器的父總線對等互連。

DXGK_WHICHSPACE_ROM

從顯示配接器的擴充 ROM 讀取。

[in] Buffer

呼叫端配置的緩衝區指標，可接收從組態空間或 ROM 讀取的數據。

[in] Offset

位移，進入設定空間或展開 ROM，讀取交易開始處。

[in] Length

要讀取的位元組數。

[out] BytesRead

ULONG 型別變數的指標，可接收實際讀取的位元元組數目。

傳回值

DxgkCbReadDeviceSpace 會傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	此函數已成功。
STATUS_INVALID_PARAMETER	DeviceHandle、DataType 或 Buffer 參數無效。
STATUS_UNSUCCESSFUL	函式無法讀取數據。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	dispmprt.h (包括 Dispmprt.h)
IRQL	PASSIVE_LEVEL

另請參閱

DxgkCbWriteDeviceSpace