次の方法で共有


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
EventBufferLengthEVENT_BUFFER_MAX_LENGTHより大きいです。
STOR_STATUS_INVALID_PARAMETER
いずれかのパラメーターへのポインターが 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 バージョン 1703
サポートされる最小サーバー Windows Server 2016
ターゲット プラットフォーム ウィンドウズ
ヘッダー storport.h (Storport.h を含む)
IRQL 任意

関連項目

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx