共用方式為


WdfPdoAddEjectionRelationsPhysicalDevice 函式 (wdfpdo.h)

[僅適用於 KMDF]

WdfPdoAddEjectionRelationsPhysicalDevice 方法指出當另一個指定的裝置退出時,會退出指定的裝置。

語法

NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT PhysicalDevice
);

參數

[in] Device

架構裝置物件的句柄。

[in] PhysicalDevice

呼叫端提供的DEVICE_OBJECT結構的指標,代表 PDO ) 實體裝置物件 (。

傳回值

如果作業成功,方法會傳回STATUS_SUCCESS。 其他傳回值包括:

傳回碼 Description
STATUS_INVALID_PARAMETER
輸入參數為 NULL
STATUS_INSUFFICIENT_RESOURCES
記憶體配置失敗。
 

方法也可能傳回其他 NTSTATUS值

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

備註

PhysicalDevice 參數會指向退出裝置的 PDO,該裝置在裝置所識別的裝置退出時會退出。 一般而言,這兩個裝置都是由呼叫驅動程式所控制。 請勿報告 裝置 的子裝置,因為當 PnP 管理員退出父裝置時,也會退出裝置的子系。

如需詳細資訊,請參閱 支援退出的裝置

範例

下列程式代碼範例會將 pPhysicalDeviceObject 結構所代表的裝置新增至裝置清單中,該 裝置在裝置 指定的裝置退出時會退出。

PDEVICE_OBJECT  pPhysicalDeviceObject;
NTSTATUS  status;
...
status = WdfPdoAddEjectionRelationsPhysicalDevice(
 device,
 pPhysicalDeviceObject
                                                  );

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
標頭 wdfpdo.h (包含 Wdf.h)
程式庫 Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf)

另請參閱

WdfPdoClearEjectionRelationsDevices

WdfPdoRemoveEjectionRelationsPhysicalDevice