kernel/eka/drivers/usbho/usbdi_utils/usbtransferstrategy.h
author hgs
Thu, 10 Jun 2010 11:48:01 +0100
changeset 149 d9f1e5bfe28c
permissions -rw-r--r--
201021_18
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
149
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     1
// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     2
// All rights reserved.
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     3
// This component and the accompanying materials are made available
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     4
// under the terms of the License "Eclipse Public License v1.0"
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     5
// which accompanies this distribution, and is available
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     7
//
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     8
// Initial Contributors:
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
     9
// Nokia Corporation - initial contribution.
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    10
//
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    11
// Contributors:
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    12
//
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    13
// Description:
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    14
//
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    15
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    16
/**
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    17
 @file
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    18
 @internalComponent
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    19
*/
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    20
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    21
#ifndef USBTRANSFERSTRATEGY_H
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    22
#define USBTRANSFERSTRATEGY_H
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    23
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    24
#include <e32std.h>
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    25
#include <d32usbtransfers.h>
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    26
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    27
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    28
NONSHARABLE_CLASS(RUsbTransferStrategy)
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    29
	{
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    30
public:
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    31
	virtual void Close();
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    32
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    33
	virtual TInt RegisterTransferDescriptor(RUsbTransferDescriptor& aTransferDesc, TInt aRequiredSize, TUint aStartAlignment, TInt aRequiredMaxPackets) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    34
	virtual void ResetTransferDescriptors() =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    35
	virtual TInt InitialiseTransferDescriptors(RUsbInterface& aInterface) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    36
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    37
public: // Interrupt transfer descriptor methods
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    38
	virtual TPtr8	IntrWritableBuffer(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    39
	virtual void	IntrSaveData(TInt aHandle, TInt aLength) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    40
	virtual void	IntrSetZlpStatus(TInt aHandle, RUsbTransferDescriptor::TZlpStatus aZlpStatus) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    41
	virtual TPtrC8	IntrBuffer(TInt aHandle) const =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    42
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    43
public: // Bulk transfer descriptor methods
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    44
	virtual TPtr8	BulkWritableBuffer(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    45
	virtual void	BulkSaveData(TInt aHandle, TInt aLength) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    46
	virtual void	BulkSetZlpStatus(TInt aHandle, RUsbTransferDescriptor::TZlpStatus aZlpStatus) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    47
	virtual TPtrC8	BulkBuffer(TInt aHandle) const =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    48
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    49
public: // Isochronous transfer descriptor methods
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    50
	virtual void	IsocReset(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    51
	virtual TPacketLengths IsocLengths(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    52
	virtual TPacketResults IsocResults(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    53
	virtual TInt	IsocMaxPacketSize(TInt aHandle) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    54
	virtual TPtr8	IsocWritablePackets(TInt aHandle, TInt aWriteHandle, TInt aNumPacketsRequested, TInt& aMaxNumPacketsAbleToWrite) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    55
	virtual TInt	IsocSaveMultiple(TInt aHandle, TInt aWriteHandle, TInt aNumOfPackets) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    56
	virtual TPtrC8	IsocPackets(TInt aHandle, TInt aFirstPacketIndex, TInt aNumPacketsRequested, TInt& aNumPacketsReturned) const =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    57
	virtual void	IsocReceivePackets(TInt aHandle, TInt aNumOfPackets) =0;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    58
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    59
protected:
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    60
	void SetTransferHandle(RUsbTransferDescriptor& aTransfer, TInt aHandle) const;
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    61
	};
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    62
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    63
d9f1e5bfe28c 201021_18
hgs
parents:
diff changeset
    64
#endif // USBTRANSFERSTRATEGY_H