DXGKARG_COLLECTDIAGNOSTICINFO構造体 (dispmprt.h)

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

さまざまな理由でプライベートドライバー情報を収集するために、DXGKDDI_COLLECTDIAGNOSTICINFO コールバック関数によって使用されます。

たとえば、OS は、要求される情報の種類 (DXGK_DIAGNOSTICINFO_TYPE) を指定しながら、診断情報が必要な場合にDXGKDDI_COLLECTDIAGNOSTICINFOコールバック関数を呼び出します。ドライバーは、すべての個人情報を収集して問題を調査し、OS に送信する必要があります。

構文

typedef struct _DXGKARG_COLLECTDIAGNOSTICINFO {
  [in, optional]  HANDLE                   hAdapter;
  [in]            DXGK_DIAGNOSTICINFO_TYPE Type;
                  CHAR                     BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE];
                  CHAR                     DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE];
  union {
    [out, optional] PVOID pReserved;
  };
  [in]            UINT                     BufferSizeIn;
  [out]           UINT                     BufferSizeOut;
  [out]           PVOID                    pBuffer;
} DXGKARG_COLLECTDIAGNOSTICINFO;

メンバーズ

[in, hAdapter

ディスプレイアダプターに関連付けられているコンテキストブロックへのハンドル。

WDDM 2.6 より前では、ディスプレイミニポートドライバーの DxgkDdiAddDevice 関数は、DirectX グラフィックスカーネルサブシステムにこのハンドルを提供しました。このパラメーターは省略可能であり、ドライバーが OS にハンドルを提供できなかった場合は NULL にすることができます。

[in] Type

ドライバーが収集する必要がある情報の種類を示す DXGK_DIAGNOSTICINFO_TYPE 列挙値。

[out] BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE]

バケットの目的で問題を特定するためにドライバーが使用する文字列に対して提供される固定サイズバッファー。この文字列は、同じ問題に対してドライバーのバージョン間で一貫している必要があるため、ソース参照、ドライバーのバージョン、フェンス番号やターゲット ID などのインスタンス固有の詳細などの要素を含めないようにする必要があります。これには、失敗した内部サブコンポーネントの識別子や、モジュールの名前などの情報が含まれる場合があります (例: mismatched_driver_ihvxseries.sys)。有効なコードは 0x21-0x7E で、スペース (0x20) の代わりにアンダースコア (0x5f) を使用する必要があります。

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

バケットに使用されないインスタンス固有の詳細を記述するためにドライバーが使用する必要がある文字列に対して提供される固定サイズバッファー。ただし、mismatched_driver_versions_kmd_10.22.1111.1121,_ihvxseries:10.22.1111.1122など、特定の問題の詳細を提供するために使用できます。有効なコードは 0x21-0x7E で、スペース (0x20) の代わりにアンダースコア (0x5f) を使用する必要があります。

[out, pReserved

OS が一部の型に対して提供する可能性がある型固有の引数へのポインターのプレースホルダーとして予約されている、名前のない共用体の VOID へのポインター。この値は、拡張情報を必要としない型の場合は NULL です。

[in] BufferSizeIn

OS によって割り当てられたバッファーのサイズをバイト単位で提供する変数。 Type 値の DXGK_DI_ADDDEVICE と DXGK_DI_STARTDEVICE のサイズは0x80000前後になります。

[out] BufferSizeOut

ドライバーがプライベートデータで満たされた実際のサイズで更新する必要がある変数。プライベートデータが指定されていない場合、ドライバーは変数に 0 を割り当てる必要があります。

[out] pBuffer

プライベートドライバーデータを受け取るバッファーへのポインター。

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 1903
ヘッダー	dispmprt.h

次の方法で共有

DXGKARG_COLLECTDIAGNOSTICINFO構造体 (dispmprt.h)

構文

メンバーズ

必要条件

関連項目

フィードバック

その他のリソース