IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

IOCTL_SERENUM_GET_PORT_NAME要求は、RS-232 ポートの PortName (または Identifier) エントリ値の値を返します。「プラグ アンド プレイシリアル デバイスのレジストリ設定」を参照してください。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

[なし] :

入力バッファーの長さ

[なし] :

出力バッファー

AssociatedIrp.SystemBuffer メンバーは、Serenum がポート名の出力に使用するクライアント割り当てバッファーを指します。 ポート名は null で終わる Unicode 文字列です。

出力バッファーの長さ

Parameters.DeviceIoControl.OutputBufferLength メンバーは、クライアントによって割り当てられた出力バッファーのサイズ (バイト単位) に設定されます。

ステータス ブロック

要求が成功した場合、 Information メンバーは、クライアントの出力バッファーで返される null で終わる Unicode 文字列のサイズ (バイト単位) に設定されます。

Status メンバーは、次のいずれかの値に設定されます。

STATUS_BUFFER_TOO_SMALL

出力バッファーが小さすぎて、ポート名の文字列を保持できません。

STATUS_SUCCESS

要求が正常に完了しました。

STATUS_UNSUCCESSFUL

デバイスのレジストリ キーを開くか 、PortName (または 識別子) エントリ値を読み取るときにエラーが発生しました。

要件