WinCE USB 驱动中IssueTransfer调用相关

IssueTransfer调用相关

 

在CHub类中的AttachDevice函数中，经常会调用到类CControlPipe的函数IssueTransfer。本文介绍一下函数CControlPipe::IssueTransfer的调用过程，以及具体实现。

 

首先说说对函数CControlPipe::IssueTransfer的调用。

 

首先调用函数CControlPipe::IssueTransfer：

    status = pControlPipe->IssueTransfer(

        .

        .

        .

        TransferDoneCallbackSetEvent, // 回调函数

        m_hHubStatusChangeEvent, // 回调函数的参数

        .

        .

        .

     ); 

 

    传输处理完后，会使用传入的回调函数参数来调用回调函数。即set event m_hHubStatusChangeEvent。

 

等待事件m_hHubStatusChangeEvent，即等待传输处理结束。

    WaitForSingleObject( m_hHubStatusChangeEvent, ATTACH_TIMEOUT )

 

    若Timeout，则中断传输：

        pControlPipe->AbortTransfer( NULL, // callback function

                                     NULL, // callback parameter

                                     this ); // cancel ID

 

判断线程退出标志，若为True，则中断传输：

    pControlPipe->AbortTransfer( NULL, // callback function

                                 NULL, // callback parameter

                                 this ); // cancel ID

 

 

下面来说说函数CControlPipe::IssueTransfer的实现。

 

首先判断是否需要change address：

        if (m_bDeviceAddress ==0 && address !=0) { // Address Changed.m_bDeviceAddress在类CPipe的构造函数中被初始化。请参考Pipe相关类的继承关系。

            // CQueuedPipe的构造函数中，将m_pQueuedTransfer赋值为NULL。

            // 函数CQueuedPipe::AbortTransfer和函数CQueuedPipe::AbortQueue中会根据条件，将m_pQueuedTransfer赋值为NULL。

            // 函数CQueuedPipe::ScheduleTransfer中会取m_pUnQueuedTransfer的第一个，赋值给m_pQueuedTransfer。

            // 函数CQueuedPipe::CheckForDoneTransfers中，如果Pipe Halt了，会将m_pQueuedTransfer赋值为NULL。

            // m_pPipeQHead在函数CControlPipe::OpenPipe中被创建

            if ( m_pQueuedTransfer == NULL &&  m_pPipeQHead && m_pPipeQHead->IsActive()==FALSE) { // We need cqueue new Transfer.

                m_bDeviceAddress = address;

                // 函数CQH::SetDeviceAddress的实现：qH_StaticEndptState.qH_SESContext.DeviceAddress = dwDeviceAddress;

                m_pPipeQHead ->SetDeviceAddress(m_bDeviceAddress);

            }

            else {

                ASSERT(FALSE);

                return requestFailed;

            }

        }

 

接下来调用函数CQueuedPipe::IssueTransfer。

 

函数CQueuedPipe::IssueTransfer中：

 

    根据传入的参数定义一个STransfer对象。

 

    检查STransfer对象中的Transfer参数是否合法。

        AreTransferParametersValid(&sTransfer)

 

    判断QHead是否已经创建成功。

 

    检查成员变量m_bDeviceAddress与传入的address是否一致。

 

    如果以上条件满足。则：

 

        进入临界区。

 

        Disables the PREfast warnings 

            #pragma prefast(disable: 322, "Recover gracefully from hardware failure")

 

        进入一个__try... __except模块。

        在该模块中，执行以下操作：

 

            初始化Transfer状态参数。

 

            用当前对象的this指针和先前创建的Transfer对象在CEhcd对象的Physical Memory上创建一个CQTransfer对象。CQTransfer是CTransfer的子类。

                CQTransfer * pTransfer = new CQTransfer(this,m_pCEhcd->GetPhysMem(),sTransfer);

 

            如果创建成功，调用CQTransfer对象的Init函数。

                pTransfer->Init()

 

                函数CTransfer::Init中检查是否需要分配Control Header Memory和Data Buffer。若需要，则进行分配。

 

            若函数函数CTransfer::Init调用成功，则声明一个CQTransfer指针，并将其指向m_pUnQueuedTransfer。

 

            接下来就是将新创建的Transfer对象追加到m_pUnQueuedTransfer末尾。

 

        执行完后，恢复PREfast warnings

            #pragma prefast(pop)

 

        退出临界区。

 

        调用函数CQueuedPipe::ScheduleTransfer。

 

 

函数CQueuedPipe::ScheduleTransfe执行的操作如下：

 

    首先判断是否需要queue new Transfer，若不需要，则不进行任何操作。

    判断的条件是m_pQueuedTransfer为空，m_pUnQueuedTransfer非空。QHead存在，并且不是Active的。

 

    从m_pUnQueuedTransfer中取出第一个Transfer对象。

 

    调用函数CQTransfer::GetCQTDList获取m_pCQTDList。

 

        在函数CQTransfer::AddTransfer中会对m_pCQTDList赋值。

            m_pCQTDList = new(m_pCPhysMem) CQTD(this, ((CQueuedPipe * const)m_pCPipe)->GetQHead())

            pPrevTD= m_pCQTDList = pCurTD;

 

    调用函数CQH::QueueTD，将QHead的nextQTDPointer指向前面获取到底m_pCQTDList。

        GetQHead()->QueueTD(pCurTransfer->GetCQTDList())

 

    将先前从m_pUnQueuedTransfer中取出的Transfer对象赋值给m_pQueuedTransfer。

        m_pQueuedTransfer = pCurTransfer;

 

++参考+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

1、Pipe相关类的继承关系

//                               CPipe (ADT)

//                           /                          /

//                  CQueuedPipe (ADT)       CIsochronousPipe

//                /                  |             / 

//              /                    |               /

//   CControlPipe   CInterruptPipe  CBulkPipe