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
