NTSTATUS
EvtDevicePrepareHardware(
IN WDFDEVICE Device,
IN WDFCMRESLIST ResourceList,
IN WDFCMRESLIST ResourceListTranslated
)
{
NTSTATUS status;
PDEVICE_CONTEXT devCtx = NULL;
WDF_USB_CONTINUOUS_READER_CONFIG interruptConfig;
UNREFERENCED_PARAMETER(ResourceList);
UNREFERENCED_PARAMETER(ResourceListTranslated);
// Get device context
devCtx = GetDeviceContext(Device);
// Configure USB Interface
status = ConfigureUsbInterface(Device, devCtx);
if(!NT_SUCCESS(status))
return status;
// Configure USB Pipe
status = ConfigureUsbPipes(devCtx);
if(!NT_SUCCESS(status))
return status;
// Init Power Management
status = InitPowerManagement(Device, devCtx);
if(!NT_SUCCESS(status))
return status;
/*Set up the interrupt endpoint with a continuous read operation. that
way we are guaranteed that no interrupt data is lost.*/
WDF_USB_CONTINUOUS_READER_CONFIG_INIT(&interruptConfig,
EvtUsbDeviceInterrupt, // Interrupt Event
devCtx,
sizeof(BYTE));
status = WdfUsbTargetPipeConfigContinuousReader(
devCtx->UsbInterruptPipe,
&interruptConfig);
if(!NT_SUCCESS(status))
{
KdPrint((__DRIVER_NAME
"WdfUsbTargetPipeConfigContinuousReader failed with status 0x%08x\n", status));
return status;
}
return status;
}
// 此函数类似于WDM中的PNP_MN_START_DEVICE函数，紧接着PnpAdd之后被调用。
// 此时PNP管理器经过甄别之后，已经决定将那些系统资源分配给当前设备。
// 参数ResourceList和ResourceListTranslated代表了这些系统资源。
// 当个函数被调用时候，设备已经进入了D0电源状态；函数完成后，设备即正式进入工作状态。
NTSTATUS DrvClass::PnpPrepareHardware(IN WDFCMRESLIST ResourceList, IN WDFCMRESLIST ResourceListTranslated)
{
NTSTATUS status;
PDEVICE_CONTEXT pContext = NULL;
ULONG ulNumRes = 0;
ULONG ulIndex;
CM_PARTIAL_RESOURCE_DESCRIPTOR* pResDes = NULL;
KDBG(DPFLTR_INFO_LEVEL, "[PnpPrepareHardware]");
pContext = GetDeviceContext(m_hDevice);
// 配置设备
status = ConfigureUsbDevice();
if(!NT_SUCCESS(status))
return status;
// 获取Pipe句柄
status = GetUsbPipes();
if(!NT_SUCCESS(status))
return status;
// 初始电源策略，
status = InitPowerManagement();
// 获取USB总线驱动接口。总线接口中包含总线驱动提供的回调函数和其他信息。
// 总线接口由系统共用GUID标识。
status = WdfFdoQueryForInterface(
m_hDevice,
&USB_BUS_INTERFACE_USBDI_GUID1, // 总线接口ID
(PINTERFACE)&m_busInterface, // 保存在设备环境块中
sizeof(USB_BUS_INTERFACE_USBDI_V1),
1, NULL);
// 调用接口函数，判断USB版本。
if(NT_SUCCESS(status) && m_busInterface.IsDeviceHighSpeed){
if(m_busInterface.IsDeviceHighSpeed(m_busInterface.BusContext))
KDBG(DPFLTR_INFO_LEVEL, "USB 2.0");
else
KDBG(DPFLTR_INFO_LEVEL, "USB 1.1");
}
// 对系统资源列表，我们不做实质性的操作，仅仅打印一些信息。
// 读者完全可以把下面的这些代码都注释掉。
ulNumRes = WdfCmResourceListGetCount(ResourceList);
KDBG(DPFLTR_INFO_LEVEL, "ResourceListCount:%d\n", ulNumRes);
// 下面我们饶有兴致地枚举这些系统资源，并打印出它们的相关名称信息。
for(ulIndex = 0; ulIndex < ulNumRes; ulIndex++)
{
pResDes = WdfCmResourceListGetDescriptor(ResourceList, ulIndex);
if(!pResDes)continue; // 取得失败，则跳到下一个
switch (pResDes->Type)
{
case CmResourceTypeMemory:
KDBG(DPFLTR_INFO_LEVEL, "System Resource：CmResourceTypeMemory\n");
break;
case CmResourceTypePort:
KDBG(DPFLTR_INFO_LEVEL, "System Resource：CmResourceTypePort\n");
break;
case CmResourceTypeInterrupt:
KDBG(DPFLTR_INFO_LEVEL, "System Resource：CmResourceTypeInterrupt\n");
break;
default:
KDBG(DPFLTR_INFO_LEVEL, "System Resource：Others %d\n", pResDes->Type);
break;
}
}
return STATUS_SUCCESS;
}
