IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

La requête IOCTL_SERENUM_GET_PORT_NAME renvoie la valeur de la valeur d’entrée PortName (ou Identificateur) pour le port RS-232. Consultez Paramètres du Registre pour un appareil série Plug-and-Play.

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Aucun.

Longueur de la mémoire tampon d’entrée

Aucun.

Mémoire tampon de sortie

Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon allouée par le client que Serenum utilise pour générer le nom du port. Le nom de port est une chaîne Unicode terminée par null.

Longueur de la mémoire tampon de sortie

Le membre Parameters.DeviceIoControl.OutputBufferLength est défini sur la taille en octets d’une mémoire tampon de sortie allouée par le client.

Bloc d’état

Si la requête réussit, le membre Information est défini sur la taille en octets de la chaîne Unicode terminée par null qui est retournée dans la mémoire tampon de sortie du client.

Le membre Status est défini sur l’une des valeurs suivantes :

STATUS_BUFFER_TOO_SMALL

La mémoire tampon de sortie est trop petite pour contenir la chaîne de nom de port.

STATUS_SUCCESS

La demande s’est terminée avec succès.

STATUS_UNSUCCESSFUL

Une erreur s’est produite lors de l’ouverture de la clé de Registre pour l’appareil ou de la lecture de la valeur d’entrée PortName (ou Identifier).

Configuration requise