HwNProcessAddDevicePreDeviceCreate 函式 (hwnclx.h)
提供裝置準備/發行和進入/結束回呼給 Windows Driver Foundation (WDF) ,以便將裝置轉換成不同的狀態。 當WDF叫用驅動程式 的EVT_WDF_DRIVER_DEVICE_ADD 例程,但在建立裝置物件之前,客戶端驅動程序應該呼叫此函式。
語法
FORCEINLINE NTSTATUS HwNProcessAddDevicePreDeviceCreate(
_In_ WDFDRIVER Driver,
_In_ PWDFDEVICE_INIT DeviceInit,
_Out_ PWDF_OBJECT_ATTRIBUTES FdoAttributes
);
參數
[in] Driver
用戶端驅動程式架構驅動程式物件的句柄。
[in] DeviceInit
架構配置的 WDFDEVICE_INIT 結構的指標。
[out] FdoAttributes
WDF_OBJECT_ATTRIBUTES 結構的指標,描述建立用戶端驅動程式裝置對象的屬性。
傳回值
如果函式成功,則傳回STATUS_SUCCESS。 如果找不到對應的用戶端驅動程式,則傳回STATUS_INVALID_PARAMETER。 否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤狀態值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1709) |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | hwnclx.h |
程式庫 | Mshwnclxstub.lib |
IRQL | PASSIVE_LEVEL |