WdfDeviceAddDependentUsageDeviceObject 函式 (wdfdevice.h)

  • 發行項

[僅適用於 KMDF]

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

語法

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

參數

[in] Device

架構裝置物件的句柄。

[in] DependentDevice

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

傳回值

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

傳回碼 Description
STATUS_INVALID_PARAMETER
 DependentDevice 為 NULL。
STATUS_INSUFFICIENT_RESOURCES
 記憶體配置失敗。
 

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

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

備註

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

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

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

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

範例

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

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

規格需求

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

另請參閱

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject