/* public: documented fields in the urb that can be used by drivers */
struct list_head urb_list;/* list head for use by the urb's
* current owner */
struct list_head anchor_list;/* the URB may be anchored */
struct usb_anchor *anchor;
struct usb_device *dev; /* 指向這個 urb 要發送的目標 struct usb_device 的指針,這個變量必須在這個 urb 被發送到 USB 核心之前被 USB 驅動初始化.*/
struct usb_host_endpoint *ep;/* (internal) pointer to endpoint */
unsigned int pipe;/* 這個 urb 所要發送到的特定struct usb_device的端點消息,這個變量必須在這個 urb 被發送到 USB 核心之前被 USB 驅動初始化.必須由下面的函數生成*/
int status;/*
當 urb開始由 USB 核心處理或處理結束, 這個變量被設置為 urb 的當前狀態. USB 驅動可安全訪問這個變量的唯一時間是在 urb
結束處理例程函數中. 這個限制是為防止競態. 對于等時 urb, 在這個變量中成功值(0)只表示這個 urb 是否已被去鏈. 為獲得等時
urb 的詳細狀態, 應當檢查 iso_frame_desc 變量. */
unsigned int transfer_flags;/* 傳輸設置*/
void *transfer_buffer;/* 指向用于發送數據到設備(OUT urb)或者從設備接收數據(IN urb)的緩沖區指針。為了主機控制器驅動正確訪問這個緩沖, 它必須使用 kmalloc 調用來創建, 不是在堆棧或者靜態內存中。 對控制端點, 這個緩沖區用于數據中轉*/
dma_addr_t transfer_dma;/* 用于以 DMA 方式傳送數據到 USB 設備的緩沖區*/
int transfer_buffer_length;/*
transfer_buffer 或者 transfer_dma 變量指向的緩沖區大小。如果這是 0, 傳送緩沖沒有被 USB
核心所使用。對于一個 OUT 端點, 如果這個端點大小比這個變量指定的值小, 對這個 USB
設備的傳輸將被分成更小的塊，以正確地傳送數據。這種大的傳送以連續的 USB 幀進行。在一個 urb 中提交一個大塊數據, 并且使 USB
主機控制器去劃分為更小的塊, 比以連續地順序發送小緩沖的速度快得多*/
int actual_length;/*
當這個 urb 完成后, 該變量被設置為這個 urb (對于 OUT urb)發送或(對于 IN urb)接受數據的真實長度.對于 IN
urb, 必須是用此變量而非 transfer_buffer_length , 因為接收的數據可能比整個緩沖小*/
unsigned char *setup_packet;/* 指向控制urb的設置數據包指針.它在傳送緩沖中的數據之前被傳送（用于控制 urb）*/
dma_addr_t setup_dma;/* 控制 urb 用于設置數據包的 DMA 緩沖區地址,它在傳送普通緩沖區中的數據之前被傳送（用于控制 urb）*/
int start_frame;/* 設置或返回初始的幀數量（用于等時urb） */
int number_of_packets;/* 指定urb所處理的等時傳輸緩沖區的數量（用于等時urb，在urb被發送到USB核心前，必須設置） */
int interval;/*urb
被輪詢的時間間隔. 僅對中斷或等時 urb 有效. 這個值的單位依據設備速度而不同. 對于低速和高速的設備, 單位是幀, 它等同于毫秒.
對于其他設備, 單位是微幀, 等同于 1/8 毫秒. 在 urb被發送到 USB 核心之前，此值必須設置.*/
int error_count;/* 等時urb的錯誤計數，由USB核心設置 */
void *context;/* 指向一個可以被USB驅動模塊設置的數據塊. 當 urb 被返回到驅動時，可在結束處理例程中使用. */
usb_complete_t complete;/* 結束處理例程函數指針, 當 urb 被完全傳送或發生錯誤，它將被 USB 核心調用. 此函數檢查這個 urb, 并決定釋放它或重新提交給另一個傳輸中*/
struct usb_iso_packet_descriptor iso_frame_desc[0];
/* （僅用于等時urb）usb_iso_packet_descriptor結構體允許單個urb一次定義許多等時傳輸，它用于收集每個單獨的傳輸狀態*/
};

struct usb_iso_packet_descriptor {
unsigned int offset;/* 該數據包的數據在傳輸緩沖區中的偏移量（第一個字節為0） */
unsigned int length;/* 該數據包的傳輸緩沖區大小 */
unsigned int actual_length;/* 等時數據包接收到傳輸緩沖區中的數據長度 */
int status;/* 該數據包的單個等時傳輸狀態。它可以把相同的返回值作為主struct urb 結構體的狀態變量 */
};

時啟動的話，必須能夠正確恢復 */
#define URB_NO_TRANSFER_DMA_MAP0x0004/* 當 urb 包含要被發送的 DMA 緩沖時，應被置位.USB 核心使用就會使用 transfer_dma 變量指向的緩沖, 而不是被 transfer_buffer 變量指向的緩沖. */
#define URB_NO_SETUP_DMA_MAP0x0008/* 和 URB_NO_TRANSFER_DMA_MAP 類似, 這個位用來控制 DMA 緩沖已經建立的 urb. 如果它被置位, USB 核心使用 setup_dma 變量而不是 setup_packet 變量指向的緩沖. */
#define URB_NO_FSBR0x0020/*
僅 UHCI USB 主機控制器驅動使用, 并且告訴它不要試圖使用前端總線回收( Front Side Bus Reclamation)
邏輯. 這個位通常應不設置, 因為有 UHCI 主機控制器的機器會增加 CPU 負擔, 且PCI 總線會忙于等待設置了這個位的 urb */
#define URB_ZERO_PACKET0x0040/* 如果置位, 批量 OUT urb 通過發送不包含數據的短包來結束, 這時數據對齊到一個端點數據包邊界. 這被一些掉線的 USB 設備需要該位才能正確工作 */
#define URB_NO_INTERRUPT0x0080/* 如果置位, 當 urb 結束時硬件可能不產生一個中斷. 該位應當小心使用并且只在多個 urb 排隊到相同端點時才使用. USB 核心函數使用該位進行 DMA 緩沖傳送. */
#define URB_FREE_BUFFER0x0100/* Free transfer buffer with the URB */

static inline void usb_fill_bulk_urb(struct urb *urb,
struct usb_device *dev,
unsigned int pipe,
void *transfer_buffer,
int buffer_length,
usb_complete_t complete_fn,
void *context);

static inline void usb_fill_control_urb(struct urb *urb,
struct usb_device *dev,
unsigned int pipe,
unsigned char *setup_packet,
void *transfer_buffer,
int buffer_length,
usb_complete_t complete_fn,
void *context);

//struct urb *urb :指向要被初始化的 urb 的指針
//struct usb_device *dev :指向 urb 要發送到的 USB 設備.
//unsigned int pipe : urb 要被發送到的 USB 設備的特定端點. 必須使用前面提過的 usb_******pipe 函數創建
//void *transfer_buffer :指向外發數據或接收數據的緩沖區的指針.注意:不能是靜態緩沖,必須使用 kmalloc 來創建.
//int buffer_length :transfer_buffer 指針指向的緩沖區的大小
//usb_complete_t complete :指向 urb 結束處理例程函數指針
//void *context :指向一個小數據塊的指針, 被添加到 urb 結構中，以便被結束處理例程函數獲取使用.
//int interval :中斷 urb 被調度的間隔.
//函數不設置 urb 中的 transfer_flags 變量, 因此對這個成員的修改必須由驅動手動完成

/*因為函數 usb_submit_urb 可被在任何時候被調用(包括從一個中斷上下文), mem_flags 變量必須正確設置. 根據 usb_submit_urb 被調用的時間,只有 3 個有效值可用:
GFP_ATOMIC
只要滿足以下條件,就應當使用此值:
1.調用者處于一個 urb 結束處理例程,中斷處理例程,底半部,tasklet或者一個定時器回調函數.
2.調用者持有自旋鎖或者讀寫鎖. 注意如果正持有一個信號量, 這個值不必要.
3.current->state 不是 TASK_RUNNING. 除非驅動已自己改變 current 狀態,否則狀態應該一直是 TASK_RUNNING .

GFP_NOIO
驅動處于塊 I/O 處理過程中. 它還應當用在所有的存儲類型的錯誤處理過程中.