Funzione WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il metodo WdfUsbTargetPipeSetNoMaximumPacketSizeCheck disabilita il test del framework per verificare se le dimensioni del buffer di lettura di un driver sono un multiplo delle dimensioni massime dei pacchetti di una pipe USB.

Sintassi

void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
  [in] WDFUSBPIPE Pipe
);

Parametri

[in] Pipe

Handle a un oggetto pipe del framework ottenuto chiamando WdfUsbInterfaceGetConfiguredPipe.

Valore restituito

nessuno

Osservazioni

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Per evitare di ricevere dati aggiuntivi dall'attività del bus imprevisto, che a volte viene chiamato babble, i driver in genere specificano buffer di lettura che sono più delle dimensioni massime dei pacchetti della pipe. I driver ricevono le dimensioni massime dei pacchetti di una pipe USB in una struttura di WDF_USB_PIPE_INFORMATION . Per impostazione predefinita, il framework segnala un errore se un driver specifica un buffer di lettura che non corrisponde a più dimensioni massime del pacchetto della pipe. Se il driver chiama WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, il framework non segnala un errore se un buffer di lettura non è un multiplo delle dimensioni massime dei pacchetti.

Per altre informazioni sul metodo WdfUsbTargetPipeSetNoMaximumPacketSizeCheck e sulle destinazioni DI I/O USB, vedere Destinazioni di I/O USB.

Esempio

Nell'esempio di codice seguente viene disabilitato il test del framework per verificare se le dimensioni di un buffer sono più delle dimensioni massime dei pacchetti di una pipe USB.

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfusb.h (include Wdfusb.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Vedi anche

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe