Função WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)
[Aplica-se a KMDF e UMDF]
O método WdfUsbTargetPipeSetNoMaximumPacketSizeCheck desabilita o teste da estrutura de se o tamanho do buffer de leitura de um driver é um múltiplo do tamanho máximo do pacote de um pipe USB.
Sintaxe
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Parâmetros
[in] Pipe
Um identificador para um objeto de pipe de estrutura que foi obtido chamando WdfUsbInterfaceGetConfiguredPipe.
Retornar valor
Nenhum
Comentários
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Para evitar receber dados extras da atividade inesperada do barramento, que às vezes é chamada de balbuciável, os drivers geralmente especificam buffers de leitura que são um múltiplo do tamanho máximo do pacote do pipe. (Os drivers recebem o tamanho máximo do pacote de um pipe USB em uma estrutura WDF_USB_PIPE_INFORMATION .) Por padrão, a estrutura relatará um erro se um driver especificar um buffer de leitura que não seja um múltiplo do tamanho máximo do pacote do pipe. Se o driver chamar WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, a estrutura não relatará um erro se um buffer de leitura não for um múltiplo do tamanho máximo do pacote.
Para obter mais informações sobre o método WdfUsbTargetPipeSetNoMaximumPacketSizeCheck e destinos de E/S USB, consulte Destinos de E/S USB.
Exemplos
O exemplo de código a seguir desabilita o teste da estrutura de se o tamanho de um buffer é um múltiplo do tamanho máximo do pacote de um pipe USB.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Versão mínima do UMDF | 2,0 |
| Cabeçalho | wdfusb.h (include Wdfusb.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |