IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

La richiesta di IOCTL_SERENUM_GET_PORT_NAME restituisce il valore della voce PortName (o Identificatore) per la porta RS-232, vedere Impostazioni del Registro di sistema per un dispositivo seriale Plug and Play.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Il membro AssociatedIrp.SystemBuffer punta a un buffer allocato dal client usato da Serenum per restituire il nome della porta. Il nome della porta è una stringa Unicode con terminazione null.

Lunghezza del buffer di output

Il membro Parameters.DeviceIoControl.OutputBufferLength è impostato sulle dimensioni in byte di un buffer di output allocato dal client.

Blocco dello stato

Se la richiesta ha esito positivo, il membro Information viene impostato sulle dimensioni in byte della stringa Unicode con terminazione null restituita nel buffer di output del client.

Il membro Status è impostato su uno dei valori seguenti:

STATUS_BUFFER_TOO_SMALL

Il buffer di output è troppo piccolo per contenere la stringa del nome della porta.

STATUS_SUCCESS

La richiesta è stata completata correttamente.

STATUS_UNSUCCESSFUL

Si è verificato un errore durante l'apertura della chiave del Registro di sistema per il dispositivo o la lettura del valore di voce PortName (o Identificatore).

Requisiti

Requisito Valore
Intestazione ntddser.h (include Ntddser.h)