Uso delle pipe USB nei driver UMDF 1.x

Avviso

UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2.

Gli esempi di UMDF 1 archiviati sono disponibili nell'aggiornamento degli esempi di driver di Windows 11 versione 22H2 - Maggio 2022.

Per altre info, vedi Introduzione con UMDF.

Il framework rappresenta ogni pipe in un'interfaccia USB come oggetto pipe USB del framework. Quando un driver configura un dispositivo USB, il framework crea un oggetto pipe USB framework per ogni pipe in ogni interfaccia selezionata. I metodi dell'oggetto pipe consentono a un driver di:

Recupero delle informazioni sulla pipe USB di UMDF

Dopo che un driver UMDF chiama il metodo IWDFUsbInterface::RetrieveUsbPipeObject per ottenere un puntatore all'interfaccia IWDFUsbTargetPipe per un oggetto pipe USB, il driver può chiamare i metodi seguenti definiti dall'oggetto pipe USB per ottenere informazioni sulla pipe USB:

IWDFUsbTargetPipe::GetInformation
Recupera informazioni su una pipe USB e il relativo endpoint.

IWDFUsbTargetPipe::GetType
Restituisce il tipo di una pipe USB.

IWDFUsbTargetPipe::IsInEndPoint
Determina se una pipe USB è connessa a un endpoint di input.

IWDFUsbTargetPipe::IsOutEndPoint
Determina se una pipe USB è connessa a un endpoint di output.

IWDFUsbTargetPipe::RetrievePipePolicy
Recupera un criterio di pipe WinUsb.

Lettura da una pipe USB UMDF

Per leggere i dati da una pipe di input USB, il driver può usare entrambe le tecniche seguenti:

Scrittura in una pipe UMDF-USB

Per scrivere dati in una pipe di output USB, un driver UMDF può prima chiamare il metodo IWDFIoTarget::FormatRequestForWrite per compilare una richiesta di scrittura. Il driver può quindi chiamare il metodo IWDFIoRequest::Send per inviare la richiesta in modo asincrono.

Arresto, scaricamento e reimpostazione di una pipe UMDF-USB

Un driver UMDF può chiamare i metodi seguenti per arrestare, scaricare o reimpostare una pipe USB:

IWDFUsbTargetPipe::Abort
Invia in modo sincrono una richiesta per arrestare tutti i trasferimenti in sospeso su una pipe USB.

IWDFUsbTargetPipe::Flush
Invia in modo sincrono una richiesta di eliminare i dati salvati da WinUsb quando il dispositivo ha restituito più dati rispetto al client richiesto.

IWDFUsbTargetPipe::Reset
Invia in modo sincrono una richiesta per reimpostare una pipe USB.

Impostazione dei criteri per una pipe UMDF-USB

Un driver UMDF può chiamare il metodo IWDFUsbTargetPipe::SetPipePolicy per controllare il comportamento usato da WinUsb per una pipe USB (ad esempio timeout, gestione di pacchetti brevi e altri comportamenti).

Gestione degli errori della pipe

Se la destinazione USB del driver completa una richiesta di I/O con un valore di stato di errore, il driver deve eseguire le operazioni seguenti:

  1. Chiamare IWDFIoTargetStateManagement::Stop con il flag WdfIoTargetCancelSentIo impostato. Questa chiamata arresta la pipe e annulla eventuali richieste di I/O aggiuntive inviate dal driver alla destinazione USB, se la destinazione non ha completato le richieste.

  2. Chiamare IWDFUsbTargetPipe::Abort per inviare una richiesta di interruzione alla pipe.

  3. Chiamare IWDFUsbTargetPipe::Reset per inviare una richiesta di reimpostazione alla pipe.

  4. Chiamare IWDFIoTargetStateManagement::Start per riavviare la pipe.

  5. Inviare nuovamente la richiesta di I/O non riuscita e tutte le richieste di I/O che hanno seguito la richiesta non riuscita.