コールバック関数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
対象プラットフォーム	デスクトップ
Header	dispmprt.h (Dispmprt.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

DxgkCbWriteDeviceSpace