閱讀英文

共用方式為

DXGKCB_READ_DEVICE_SPACE回呼函式 （dispmprt.h）

  • 發行項

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 會傳回下列其中一個值：

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

要求

要求 價值
最低支援的用戶端 Windows Vista
目標平臺 桌面
標頭 dispmprt.h （包括 Dispmprt.h）
IRQL PASSIVE_LEVEL

另請參閱

DxgkCbWriteDeviceSpace