StorPortLogTelemetryEx 関数 (storport.h)
StorPortLogTelemetry ルーチンは、ミニポート テレメトリ イベントをログに記録して、有用な情報を診断または収集するのに役立ちます。
構文
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
パラメーター
HwDeviceExtension
ホスト バス アダプター (HBA) のハードウェア デバイス拡張機能へのポインター。
StorAddress
記憶装置のデバイス アドレス。 このパラメーターは、アダプター デバイスの場合は NULL です。
Event
テレメトリ データ ペイロードを含む STORPORT_TELEMETRY_EVENT 構造体へのポインター。
Category
ログに記録 するテレメトリのカテゴリを指定する列挙値をSTOR_TELEMETRY_CATEGORYします。
戻り値
StorPortLogTelemetryEx は 、次のいずれかの状態コードを返します。
| リターン コード | 説明 |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | イベント->EventBufferLength がEVENT_BUFFER_MAX_LENGTHより大きい。 |
| STOR_STATUS_INVALID_PARAMETER | パラメーターの 1 つへのポインターが NULL であるか、NULL 以外の Event-EventBuffer> の場合は EventBufferLength が 0 に設定されます。 |
| STOR_STATUS_NOT_IMPLEMENTED | この関数は、アクティブなオペレーティング システムには実装されません。 |
| STOR_STATUS_SUCCESS | テレメトリ イベントが正常にログに記録されました。 |
注釈
ミニポートは 、StorPortLogTelemetryEx を呼び出して、ミニポートカスタマイズされたデータを使用してトレース ログ メジャーまたはテレメトリ イベントをログに記録できます。 ミニポートは、カテゴリでイベント カテゴリの種類を指定 します。
イベント データは、Event がポイントするSTORPORT_TELEMETRY_EVENT構造にカプセル化されます。 ミニポートは、8 つの汎用の名前と値のペアと、最大長が 4 KB のバッファー、および複数のイベント関連フィールドをログに記録できます。
要件
| 要件 | 値 |
|---|---|
| Header | storport.h |