Funzione WdfUsbTargetPipeSetNoMaximumPacketSizeCheck (wdfusb.h)
[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) |