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 は、次のいずれかの状態コードを返します。

リターン コード 説明
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength が EVENT_BUFFER_MAX_LENGTHより大きい。
STOR_STATUS_INVALID_PARAMETER
 パラメーターの 1 つへのポインターが NULL であるか、Event 構造体の EventBufferLength/EventBuffer が一致しません。
STOR_STATUS_NOT_IMPLEMENTED
 この関数は、アクティブなオペレーティング システムには実装されません。
STATUS_SUCCESS
 テレメトリ イベント データが正常にログに記録されました。

注釈

Event 構造体のパラメーターの名前が Event-ParameterNameX> == NULL でない場合、ルーチンは対応するパラメーター値を 0 に設定します。

ミニポートに Event-EventBuffer> に入力するペイロードがない場合は、Event-EventBufferLength> = 0 と Event-EventBuffer> = NULL を設定する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 10 Version 1703
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
ヘッダー storport.h (Storport.h を含む)
IRQL Any

こちらもご覧ください

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx