WdfDeviceWdmGetAttachedDevice 函式 (wdfdevice.h)

[僅適用於 KMDF]

WdfDeviceWdmGetAttachedDevice 方法會傳回裝置堆疊中的下一個較低 WDM 裝置物件。

語法

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

參數

[in] Device

架構裝置物件的句柄。

傳回值

WdfDeviceWdmGetAttachedDevice 會傳回 WDM DEVICE_OBJECT 結構的指標。 如果指定的物件句柄代表實體裝置物件 (PDO) ，此方法會傳回 NULL。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

備註

WdfDeviceWdmGetAttachedDevice 方法傳回的指標有效，直到刪除架構裝置對象為止。 如果驅動程式為架構裝置物件提供 EvtCleanupCallback 函式，則指標會有效，直到回呼函式傳回為止。

範例

下列程式代碼範例會建立追蹤訊息，其中包含代表裝置 PDO、FDO 和下一個較低裝置之 WDM 裝置物件的指標。

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

規格需求

另請參閱

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice