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
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) |