StorPortLogTelemetry 関数 (storport.h)
StorPortLogTelemetry ルーチンは、ミニポート テレメトリ イベントをログに記録して、有用な情報を診断または収集します。 ミニポートは、8 つの汎用の名前と値のペアと 4 KB の最大長を持つバッファーだけでなく、構造体 STORPORT_TELEMETRY_EVENTで定義されているいくつかのイベント関連フィールドをログに記録できます。
構文
ULONG StorPortLogTelemetry(
[in] PVOID HwDeviceExtension,
[in, optional] PSTOR_ADDRESS StorAddress,
[in] PSTORPORT_TELEMETRY_EVENT Event
);
パラメーター
[in] HwDeviceExtension
ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。
[in, optional] StorAddress
ストレージ・ユニット・デバイス・アドレス。 このパラメーターは、アダプター デバイスの場合は NULL です。
[in] Event
テレメトリ データ ペイロードを含むSTORPORT_TELEMETRY_EVENT構造体へのポインター。
戻り値
StorPortLogTelemetry は、次のいずれかの状態コードを返します。
リターン コード | 形容 |
---|---|
|
EventBufferLength が EVENT_BUFFER_MAX_LENGTHより大きいです。 |
|
いずれかのパラメーターへのポインターが NULL であるか、Event 構造体の EventBufferLength/EventBuffer が一致しません。 |
|
この関数は、アクティブなオペレーティング システムでは実装されません。 |
|
テレメトリ イベント データが正常にログに記録されました。 |
備考
Event 構造体のパラメーターに Event->ParameterNameX == NULL が指定されていない場合、ルーチンは対応するパラメーター値を 0 に設定します。
ミニポートに Event->EventBuffer に格納するペイロードがない場合は、Event->EventBufferLength = 0、および Event->EventBuffer = NULL を設定する必要があります。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 10 バージョン 1703 |
サポートされる最小サーバー | Windows Server 2016 |
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | storport.h (Storport.h を含む) |
IRQL | 任意 |
関連項目
StorPortLogTelemetryEx の