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 del pacchetto di una pipe USB.
Sintassi
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
Parametri
[in] Pipe
Handle per un oggetto pipe del framework ottenuto chiamando WdfUsbInterfaceGetConfiguredPipe.
Valore restituito
Nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Per evitare di ricevere dati aggiuntivi dall'attività imprevista del bus, talvolta chiamata babble, i driver specificano in genere buffer di lettura che sono una dimensione massima del pacchetto della pipe. I driver ricevono la dimensione massima del pacchetto di una pipe USB in una struttura WDF_USB_PIPE_INFORMATION. Per impostazione predefinita, il framework segnala un errore se un driver specifica un buffer di lettura che non è un multiplo delle 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 del pacchetto.
Per altre informazioni sul metodo WdfUsbTargetPipeSetNoMaximumPacketSizeCheck e sulle destinazioni di I/O USB, vedere Destinazioni I/O USB.
Esempi
Nell'esempio di codice seguente viene disabilitato il test del framework per verificare se le dimensioni di un buffer sono multiple delle dimensioni massime del pacchetto di una pipe USB.
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |