本文主要是介绍windows wdf 驱动开发总结(1)--usb驱动，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
(一)EZ-USB-Fx2 USB驱动相关
(1)WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE
功能：初始化驱动的WDF_IO_QUEUE_CONFIG结构
VOIDWDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
__out PWDF_IO_QUEUE_CONFIG Config, __in WDF_IO_QUEUE_DISPATCH_TYPE DispatchType);Parameters
Config [out]
A pointer to the driver's WDF_IO_QUEUE_CONFIG structure.
DispatchType [in]
A WDF_IO_QUEUE_DISPATCH_TYPE enumerator that identifies the request dispatching type for the queue.
typedef enum _WDF_IO_QUEUE_DISPATCH_TYPE {
WdfIoQueueDispatchInvalid = 0,
WdfIoQueueDispatchSequential = 1,
WdfIoQueueDispatchParallel = 2,
WdfIoQueueDispatchManual = 3,
WdfIoQueueDispatchMax = 4
} WDF_IO_QUEUE_DISPATCH_TYPE;
typedef struct _WDF_IO_QUEUE_CONFIG {
ULONG Size;
WDF_IO_QUEUE_DISPATCH_TYPE DispatchType;
WDF_TRI_STATE PowerManaged;
BOOLEAN AllowZeroLengthRequests;
BOOLEAN DefaultQueue;
PFN_WDF_IO_QUEUE_IO_DEFAULT EvtIoDefault;
PFN_WDF_IO_QUEUE_IO_READ EvtIoRead;
PFN_WDF_IO_QUEUE_IO_WRITE EvtIoWrite;
PFN_WDF_IO_QUEUE_IO_DEVICE_CONTROL EvtIoDeviceControl;
PFN_WDF_IO_QUEUE_IO_INTERNAL_DEVICE_CONTROL EvtIoInternalDeviceControl;
PFN_WDF_IO_QUEUE_IO_STOP EvtIoStop;
PFN_WDF_IO_QUEUE_IO_RESUME EvtIoResume;
PFN_WDF_IO_QUEUE_IO_CANCELED_ON_QUEUE EvtIoCanceledOnQueue;
union {
struct {
ULONG NumberOfPresentedRequests;
} Parallel;
} Settings;
} WDF_IO_QUEUE_CONFIG, *PWDF_IO_QUEUE_CONFIG;
(2) WdfDeviceCreate
函数功能：建立一个设备对象框架(creates a framework device object)
NTSTATUS WdfDeviceCreate(
[in, out] PWDFDEVICE_INIT *DeviceInit,
[in, optional] PWDF_OBJECT_ATTRIBUTES DeviceAttributes,
[out] WDFDEVICE *Device
);
参数：
DeviceInit [in, out]
The address of a pointer to a WDFDEVICE_INIT structure. If WdfDeviceCreate encounters no errors, it sets the pointer to NULL.
DeviceAttributes [in, optional]
A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that contains attributes for the new object. (The structure's ParentObject member must be NULL.) This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
Device [out]
A pointer to a location that receives a handle to the new framework device object.
(3) WdfDriverCreate
函数功能：为了调用驱动，建立驱动对象
NTSTATUS WdfDriverCreate(
[in] PDRIVER_OBJECT DriverObject,
[in] PCUNICODE_STRING RegistryPath,
[in, optional] PWDF_OBJECT_ATTRIBUTES DriverAttributes,
[in] PWDF_DRIVER_CONFIG DriverConfig,
[out, optional] WDFDRIVER *Driver
);
DriverObject [in]
A pointer to a DRIVER_OBJECT structure that represents a Windows Driver Model (WDM) driver object. The driver receives this pointer as input to its DriverEntry routine.
RegistryPath [in]
A pointer to a UNICODE_STRING structure that contains the registry path string that the driver received as input to its DriverEntry routine.
DriverAttributes [in, optional]
A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure. (The structure's ParentObject member must be NULL.) This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
DriverConfig [in]
A pointer to a caller-allocated WDF_DRIVER_CONFIG structure.
Driver [out, optional]
A pointer to a location that receives a handle to the new framework driver object. This parameter is optional and can be WDF_NO_HANDLE.
typedef struct _WDF_OBJECT_ATTRIBUTES {
ULONG Size;
PFN_WDF_OBJECT_CONTEXT_CLEANUP EvtCleanupCallback;
PFN_WDF_OBJECT_CONTEXT_DESTROY EvtDestroyCallback;
WDF_EXECUTION_LEVEL ExecutionLevel;
WDF_SYNCHRONIZATION_SCOPE SynchronizationScope;
WDFOBJECT ParentObject;
size_t ContextSizeOverride;
PCWDF_OBJECT_CONTEXT_TYPE_INFO ContextTypeInfo;
} WDF_OBJECT_ATTRIBUTES, *PWDF_OBJECT_ATTRIBUTES;
(4) WdfIoQueueCreate
函数功能：creates and configures an I/O queue for a specified device
NTSTATUS WdfIoQueueCreate(
[in] WDFDEVICE Device,
[in] PWDF_IO_QUEUE_CONFIG Config,
[in, optional] PWDF_OBJECT_ATTRIBUTES QueueAttributes,
[out, optional] WDFQUEUE *Queue
);
Device [in]
A handle to the framework device object that the queue will be associated with.
Config [in]
A pointer to a caller-allocated WDF_IO_QUEUE_CONFIG structure.
QueueAttributes [in, optional]
A pointer to a caller-allocated WDF_OBJECT_ATTRIBUTES structure that specifies object attributes for the new object. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES.
Queue [out, optional]
A pointer to a location that receives a handle to a framework queue object.
评论：
Each call to WdfIoQueueCreate creates an I/O queue for a device. Your driver can create multiple I/O queues for each device.
The Config and QueueAttributes parameters specify the queue's configuration and object attributes.
(5) WdfDeviceCreateDeviceInterface
函数功能：创建设备接口creates a device interface for a specified device.
NTSTATUS WdfDeviceCreateDeviceInterface(
[in] WDFDEVICE Device,
[in] const GUID *InterfaceClassGUID,
[in, optional] PCUNICODE_STRING ReferenceString
);
参数：
Device [in]
A handle to a framework device object.
InterfaceClassGUID [in]
A pointer to a GUID that identifies the device interface class.
ReferenceString [in, optional]
A pointer to a UNICODE_STRING structure that describes a reference string for the device interface. This parameter is optional and can be NULL. For more information, see the following Remarks section.
Copy Code 调用例子
NTSTATUS status;
status = WdfDeviceCreateDeviceInterface(
Device,
(LPGUID) &GUID_DEVINTERFACE_COMPORT,
NULL
);
(6) WdfRequestComplete
函数功能：completes a specified I/O request and supplies a completion status.
VOID WdfRequestComplete(
[in] WDFREQUEST Request,
[in] NTSTATUS Status
);
(7) WdfRequestRetrieveInputBuffer
函数功能：retrieves an I/O request's input buffer. 获取输入缓冲区的地址
NTSTATUS WdfRequestRetrieveInputBuffer(
[in] WDFREQUEST Request,
[in] size_t MinimumRequiredSize,
[out] PVOID *Buffer,
[out, optional] size_t *Length
);
Request [in]
A handle to a framework request object.
MinimumRequiredSize [in]
The minimum buffer size, in bytes, that the driver needs to process the I/O request.
Buffer [out]
A pointer to a location that receives the buffer's address.
Length [out, optional]
A pointer to a location that receives the buffer's size, in bytes. This parameter is optional and can be NULL.
(8) WdfRequestRetrieveOutputBuffer
函数功能：获取输出缓冲区的地址
NTSTATUS WdfRequestRetrieveInputBuffer(
[in] WDFREQUEST Request,
[in] size_t MinimumRequiredSize,
[out] PVOID *Buffer,
[out, optional] size_t *Length
);
(9) WdfRequestCompleteWithInformation
函数功能：stores completion information and then completes a specified I/O request with a supplied completion status.（完成Io请求）
VOID WdfRequestCompleteWithInformation(
[in] WDFREQUEST Request,
[in] NTSTATUS Status,
[in] ULONG_PTR Information
);
queuesample(队列例子)
(10)GetDeviceContext
//获取设备对象环境变量结构地址指针
pDeviceContext = GetDeviceContext(device);
deviceContext = GetDeviceContext(WdfIoQueueGetDevice(Queue));
(11) WdfIoQueueRetrieveNextRequest
函数功能： 从非缺省手工队列中取出I/O请求，做相应处理
NTSTATUS
WdfIoQueueRetrieveNextRequest(
IN WDFQUEUE Queue,
OUT WDFREQUEST* OutRequest
);
Queue
A handle to a framework queue object.
OutRequest
A pointer to a location that receives a handle to a framework request object. If the queue is empty or the last request has been retrieved, this parameter receives NULL.
(12) WdfTimerStop
函数功能：关闭定时器
BOOLEAN
WdfTimerStop(
IN WDFTIMER Timer,
IN BOOLEAN Wait
);
Timer
A handle to a framework timer object that was obtained by calling WdfTimerCreate.
Wait
A Boolean value that, if TRUE, specifies that the framework does not return until all queued calls to the driver's deferred procedure calls (DPCs), including the driver's EvtTimerFunc callback functions, have executed.
WdfTimerStop returns TRUE if the timer object was in the system's timer queue. Otherwise, this method returns FALSE.
(13) WdfRequestForwardToIoQueue
函数功能：requeues an I/O request to one of the calling driver's I/O queues.
NTSTATUS WdfRequestForwardToIoQueue(
[in] WDFREQUEST Request,
[in] WDFQUEUE DestinationQueue
);
Request [in]
A handle to a framework request object.
DestinationQueue [in]
A handle to a framework queue object.
The driver must own the I/O request and must have obtained the request from one of its I/O queues.
The source and destination queues cannot be the same. In other words, the driver cannot call WdfRequestForwardToIoQueue to return a request to the queue that it came from. To requeue a request to the same queue, use WdfRequestRequeue .
这篇关于windows wdf 驱动开发总结(1)--usb驱动的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
