EVT_WDF_DEVICE_PREPARE_HARDWARE API

本文介绍: 翻译后的资源列表表示设备在系统中实际使用的资源，经过了操作系统的翻译和重映射。ResourceXlated中也有同样的IRQ，这是经过oS翻译后映射的，也是OS实际使用的IRQ，是Vector，中断向量。反映了实际运行时使用的资源，通常驱动程序会更关心这个列表，因为它反映了系统在运行时为设备提供的实际硬件资源。回调函数中，驱动程序通常需要检查并使用这两个资源列表中的信息来配置设备，准备设备在系统中的运行环境。此处显示的值为ResourceRaw中的值，是真实的硬件IRQ，没有经过OS翻译映射的。

NTSTATUS
EVT_WDF_DEVICE_PREPARE_HARDWARE(
    __in
    WDFDEVICE Device,
    __in
    WDFCMRESLIST ResourcesRaw,
    __in
    WDFCMRESLIST ResourcesTranslated
    );

上面API中ResourcesRaw和ResourcesTranslated类型相同，那他们的区别是啥？

答：

EVT_WDF_DEVICE_PREPARE_HARDWARE 是 WDF (Windows Driver Framework) 中的一个回调函数，用于为设备准备硬件。在这个回调函数中，ResourcesRaw 和 ResourcesTranslated 是两个参数，它们的区别在于处理的资源列表的不同阶段。

在 EVT_WDF_DEVICE_PREPARE_HARDWARE 回调函数中，驱动程序通常需要检查并使用这两个资源列表中的信息来配置设备，准备设备在系统中的运行环境。由于 ResourcesTranslated 反映了实际运行时使用的资源，通常驱动程序会更关心这个列表，因为它反映了系统在运行时为设备提供的实际硬件资源。

UINT32 dev_parse_hw_irq(WDFCMRESLIST resources)
{
   // Parse the resource list and save the resource information.
   PCM_PARTIAL_RESOURCE_DESCRIPTOR desc;
   for(UINT32 i = 0; i < WdfCmResourceListGetCount(resources); ++i) {
      desc = WdfCmResourceListGetDescriptor(resources, i);
      if(!desc) {
         trace(("WdfResourceCmGetDescriptor failed"));
         break;
      }

      if(desc->Type == CmResourceTypeInterrupt) {
         // MSI Interrupt
         if (desc->Flags & CM_RESOURCE_INTERRUPT_MESSAGE) {
            can_trace(("MSI interrupt number: 0x%x", desc->u.MessageInterrupt.Translated.Vector));
            return desc->u.MessageInterrupt.Translated.Vector;
         } else { // Legacy Interrupt
            trace(("Legacy interrupt number: 0x%x", desc->u.Interrupt.Level));
            return desc->u.Interrupt.Level;
         }
      }
   }

   return -1;
}