共用方式為

WdfDeviceAddDependentUsageDeviceObject 函式 （wdfdevice.h）

  • 發行項

[僅適用於 KMDF]

WdfDeviceAddDependentUsageDeviceObject 方法表示當指定裝置用來儲存 特殊檔案時，指定的裝置相依於另一個裝置。

語法

NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT DependentDevice
);

參數

[in] Device

架構裝置物件的句柄。

[in] DependentDevice

呼叫端提供的 DEVICE_OBJECT 結構的指標，可識別 裝置 相依的裝置。

傳回值

如果作業成功，WdfDeviceAddDependentUsageDeviceObject 方法會傳回STATUS_SUCCESS。 其他傳回值包括：

傳回碼 描述
STATUS_INVALID_PARAMETER
 DependentDeviceNULL。
STATUS_INSUFFICIENT_RESOURCES
 記憶體配置失敗。
 

方法可能會 傳回其他NTSTATUS 值。

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

言論

當 Device 支援特殊檔案時，驅動程式可以呼叫 WdfDeviceAddDependentUsageDeviceObject，指出 Device 所識別的裝置取決於 DependentDevice所識別的裝置。 如果您的驅動程式呼叫 WdfDeviceAddDependentUsageDeviceObject，則架構會在 DependentDevice的驅動程式中呼叫 EvtDeviceUsageNotification 回呼函式，再呼叫 Device驅動程式中的 EvtDeviceUsageNotification 回呼函式。

驅動程式可以呼叫 WdfDeviceAddDependentUsageDeviceObject 多次，以識別 裝置 相依的多個裝置，以支援特殊檔案。

在驅動程式呼叫 WdfDeviceAddDependentUsageDeviceObject之後，它可以呼叫 WdfDeviceRemoveDependentUsageDeviceObject，以從 Device 相依的裝置列表中移除 DependentDevice 所識別的裝置。

如需特殊檔案的詳細資訊，請參閱 支援特殊檔案。

例子

下列程式代碼範例會將裝置 （pDeviceObject） 新增至另一個裝置 （Device） 相依的裝置清單。

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfdevice.h （包括 Wdf.h）
連結庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另請參閱

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject