Função WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)

  • Artigo

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

Confira também

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe