SendRPL-Funktion

Artikel
06/15/2023

Die SendRPL WMI-Methode sendet einen RPL-Befehl (Read Port List) über den angegebenen Port an den angegebenen Zielport.

Syntax

void SendRPL(
   [out, HBA_STATUS_QUALIFIERS] HBA_STATUS       HBAStatus,
   [in, HBAType("HBA_WWN")] uint8                PortWWN[8],
   [in, HBAType("HBA_WWN")] uint8                AgentWWN[8],
   [in] uint32                                   agent_domain,
   [in] uint32                                   portIndex,
   [out] uint32                                  TotalRspBufferSize,
   [out] uint32                                  ActualRspBufferSize,
   [out, WmiSizeIs("ActualRspBufferSize")] uint8 RspBuffer[]
);

Parameter

HBAStatus
Enthält bei rückgabe die status des Vorgangs. Eine Liste der zulässigen Werte und deren Beschreibungen finden Sie unter HBA_STATUS. Der Miniporttreiber gibt diese Informationen im HBAStatus-Member einer SendRPL_OUT-Struktur zurück.

PortWWN
Ein weltweiter Name für den lokalen Port, über den der RPL-Befehl (Read Port List) gesendet wird. Diese Informationen werden an den Miniporttreiber im PortWWN-Member einer SendRPL_IN-Struktur übermittelt.

AgentWWN
Ein weltweiter Name für den Port, der nach einer Liste von Ports vom Typ FC_Port abgefragt werden soll. Eine Definition von FC_Port finden Sie in der Fibre Channel HBA-API-Spezifikation des T11-Komitees. Diese Informationen werden an den Miniporttreiber im AgentWWN-Member einer SendRPL_IN-Struktur übermittelt.

agent_domain
Die Domänennummer für den Domänencontroller, der nach einer Liste von Ports vom Typ FC_Port abgefragt werden soll. Eine Definition von FC_Port finden Sie in der Fibre Channel HBA-API-Spezifikation des T11-Komitees. Diese Informationen werden an den Miniporttreiber im agent_domain Member einer SendRPL_IN-Struktur übermittelt.

portIndex
Der Portindex des ersten Ports in der Liste der Ports vom Typ FC_Port zurückgegeben werden. Diese Informationen werden an den Miniporttreiber im portIndex-Member einer SendRPL_IN-Struktur übermittelt.

TotalRspBufferSize
Die Größe der Ergebnisse des RPL-Befehls (Read Port List) in Bytes. Der Miniporttreiber gibt diese Informationen im TotalRspBufferSize-Member einer SendRPL_OUT-Struktur zurück.

ActualRspBufferSize
Die Größe der tatsächlich abgerufenen Daten in Bytes. Der Miniporttreiber gibt diese Informationen im ActualRspBufferSize-Member einer SendRPL_OUT-Struktur zurück.

RspBuffer
Die Ergebnisse des RPL-Befehls (Read Port List). Der Miniporttreiber gibt diese Informationen im RspBuffer-Member einer SendRPL_OUT-Struktur zurück.