StorPortLogTelemetryEx - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// storport.h
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
View the official Windows Driver Kit DDI referenceNo description available.
The StorPortLogTelemetry routine logs a miniport telemetry event to help diagnose or collect any useful information.
HwDeviceExtensionPointer to the hardware device extension for the host bus adapter (HBA).
StorAddressStorage unit device address. This parameter is NULL for adapter devices.
EventPointer to the STORPORT_TELEMETRY_EVENT structure that contains the telemetry data payload.
CategorySTOR_TELEMETRY_CATEGORY enum value that specifies the category of telemetry to be logged.
StorPortLogTelemetryEx returns one of the following status codes:
| Return code | Description |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | Event->EventBufferLength is larger than EVENT_BUFFER_MAX_LENGTH. |
| STOR_STATUS_INVALID_PARAMETER | A pointer to one of the parameters is NULL or the EventBufferLength is set to zero for a non-NULL Event->EventBuffer. |
| STOR_STATUS_NOT_IMPLEMENTED | This function is not implemented on the active operating system. |
| STOR_STATUS_SUCCESS | The telemetry event was successfully logged. |
A miniport can call StorPortLogTelemetryEx to log a tracelogging measures or telemetry event with miniport-customized data. Miniports specify the event category type in Category.
The event data is encapsulated in the STORPORT_TELEMETRY_EVENT structure to which Event points. The miniport can log eight general purpose name-value pairs and a buffer that has a maximum length of 4KB, as well as several event-related fields.