DXGKCB_READ_DEVICE_SPACE コールバック関数 (dispmprt.h)

[アーティクル]
02/06/2025

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

次の方法で共有