IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)
La richiesta di IOCTL_SERENUM_GET_PORT_NAME restituisce il valore della 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 di stato
Se la richiesta ha esito positivo, il membro informazioni viene impostato sulle dimensioni in byte della stringa Unicode con terminazione Null restituita nel buffer di output del client.
Il membro stato è 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 portName (o identificatore ) valore di voce.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ntddser.h (include Ntddser.h) |