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