IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

A solicitação IOCTL_SERENUM_GET_PORT_NAME retorna o valor do valor de entrada PortName (ou Identificador) para a porta RS-232 – consulte Configurações do Registro para um dispositivo serial Plug and Play.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

O membro AssociatedIrp.SystemBuffer aponta para um buffer alocado pelo cliente que o Serenum usa para gerar o nome da porta. O nome da porta é uma cadeia de caracteres Unicode terminada em nulo.

Comprimento do buffer de saída

O membro Parameters.DeviceIoControl.OutputBufferLength é definido como o tamanho em bytes de um buffer de saída alocado pelo cliente.

Bloco de status

Se a solicitação for bem-sucedida, o membro Informações será definido como o tamanho em bytes da cadeia de caracteres Unicode terminada em nulo retornada no buffer de saída do cliente.

O membro Status é definido como um dos seguintes valores:

STATUS_BUFFER_TOO_SMALL

O buffer de saída é muito pequeno para manter a cadeia de caracteres de nome da porta.

STATUS_SUCCESS

A solicitação foi concluída com êxito.

STATUS_UNSUCCESSFUL

Ocorreu um erro ao abrir a chave do Registro para o dispositivo ou ler o valor de entrada PortName (ou Identificador ).

Requisitos