コールバック関数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 |