IOCTL_USB_NOTIFY_ON_TRANSPORT_CHARACTERISTICS_CHANGE IOCTL (usbioctl.h)

Artigo
02/26/2024

Essa solicitação notifica o chamador de alteração nas características de transporte.

Código principal

Buffer de entrada/saída

O membro AssociatedIrp.SystemBuffer é um ponteiro para uma estrutura de USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION alocada pelo chamador. Na entrada, o chamador passa o identificador de registro recuperado na solicitação de IOCTL_USB_REGISTER_FOR_TRANSPORT_CHARACTERISTICS_CHANGE anterior. Na saída, a estrutura é preenchida com as informações mais recentes sobre o tipo de informação para o qual o chamador.

Comprimento do buffer de entrada/saída

O tamanho da estrutura USB_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION .

Bloco de status

Irp->IoStatus.Status será definido como STATUS_SUCCESS se a solicitação for bem-sucedida. Caso contrário, Status indica a condição de erro apropriada como um código NTSTATUS .

Comentários

Essa solicitação é mantida pendente pela pilha do driver USB até que haja uma alteração nas características de transporte para as quais o chamador se registrou. Após a conclusão dessa solicitação, a pilha de driver USB retorna as informações no buffer de saída.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1709
Servidor mínimo com suporte	Windows Server 2016
Cabeçalho	usbioctl.h
IRQL	<=DISPATCH_LEVEL