IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)
IOCTL_SERENUM_GET_PORT_NAME要求は、RS-232 ポートの PortName (または 識別子) エントリ値の値を返します。プラグ アンド プレイ シリアル デバイス のレジストリ設定参照してください。
メジャー コード
入力バッファー
何一つ。
入力バッファーの長さ
何一つ。
出力バッファー
AssociatedIrp.SystemBuffer メンバーは、Serenum がポート名の出力に使用するクライアント割り当てバッファーを指します。 ポート名は null で終わる Unicode 文字列です。
出力バッファーの長さ
Parameters.DeviceIoControl.OutputBufferLength メンバーは、クライアントによって割り当てられた出力バッファーのサイズ (バイト単位) に設定されます。
状態ブロック
要求が成功した場合、Information メンバーは、クライアントの出力バッファーで返される null で終わる Unicode 文字列のサイズ (バイト単位) に設定されます。
Status メンバーは、次のいずれかの値に設定されます。
STATUS_BUFFER_TOO_SMALL
出力バッファーが小さすぎて、ポート名の文字列を保持できません。
STATUS_SUCCESS
要求が正常に完了しました。
STATUS_UNSUCCESSFUL
デバイスのレジストリ キーを開くか、PortName (または 識別子) エントリ値を読み取るときにエラーが発生しました。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ntddser.h (Ntddser.h を含む) |