PshedRegisterPlugin 関数 (ntddk.h)
PshedRegisterPlugin 関数は、PSHED プラグインを PSHED に登録します。
構文
NTPSHEDAPI NTSTATUS PshedRegisterPlugin(
[in, out] PWHEA_PSHED_PLUGIN_REGISTRATION_PACKET Packet
);
パラメーター
[in, out] Packet
PSHED プラグインの登録情報を記述する初期化された WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体へのポインター。
戻り値
PshedRegisterPlugin は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 説明 |
|---|---|
|
PSHED プラグインが正常に登録されました。 |
|
指定された登録パケット内のデータが無効です。 |
注釈
PSHED プラグインは PshedRegisterPlugin 関数を呼び出して、PSHED に自身を登録します。 通常、PSHED プラグインは 、DriverEntry 関数またはその AddDevice 関数内からこの関数を呼び出します。
Windows 10 バージョン 1903 (WDK 10 バージョン 18362) 以降では、PshedUnregisterPlugin 関数を呼び出すことによって、実行中のシステムでプラグインを削除および更新できる PSHED-Plugin インターフェイスの V2 を使用できます。 登録を解除できるため、V2 プラグインでは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2構造体の FunctionalAreaMask メンバーに PshedFADiscovery フラグ (検出機能領域) を指定できません。 プラグインの登録の詳細については、「PSHED プラグインの登録」を参照してください。 V1 プラグインの場合、登録を解除しようとすると、バグチェックが発生する可能性があります。 可能であれば V2 プラグインを使用することをお勧めします。これは現在の既定値です。
V1 と V2 プラグインを登録するには、正しい構造体を使用します。 V1 のWHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V1 と V2 の WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2 。
V2 プラグインは、「Windows 10での WHEA の使用」で説明されているように、または WheaAddErrorSource と WheaRemoveErrorSource を呼び出すことで、エラー ソースを追加できます。
プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET_V2構造のバージョンとして WHEA_PLUGIN_REGISTRATION_PACKET_V1 を指定することで、引き続き検出機能領域 を 使用できます。
V1 と V2 の両方のプラグイン上のすべてのコールバックは、DISPATCH_LEVELの最小 IRQL で呼び出されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2008、Windows Vista SP1、およびそれ以降のバージョンの Windows でサポートされています。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h を含む) |
| Library | Pshed.lib |
| [DLL] | Pshed.dll |
| IRQL | <=DISPATCH_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |