WDFDEVICE_INIT 結構

[適用於 KMDF 和 UMDF]

WDFDEVICE_INIT 結構是架構所定義和配置的不透明結構。

語法

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

成員

函式和篩選驅動程式會接收此結構的指標作為 EvtDriverDeviceAdd 回呼函式的輸入，或做為 WdfControlDeviceInitAllocate 的傳回值。

總線驅動程式會接收結構指標作為 EvtChildListCreateDevice 回呼函式的輸入，或作為 WdfPdoInitAllocate 的傳回值。

在驅動程式收到 WDFDEVICE_INIT 結構之後，它會將結構指標傳遞至初始化函式。 這些函式會 使用 WDFDEVICE_INIT 結構來儲存架構用來建立架構裝置物件的資訊。

若要尋找裝置初始化方法的檔，請參閱 wdfdevice.h 標頭。

呼叫初始化函式之後，驅動程式必須呼叫 WdfDeviceCreate 來建立架構裝置物件。

如果您的驅動程式從呼叫 WdfPdoInitAllocate 或 WdfControlDeviceInitAllocate 收到WDFDEVICE_INIT結構，而且驅動程式收到呼叫初始化函式的錯誤時，驅動程式必須呼叫 WdfDeviceInitFree，而不是 WdfDeviceCreate。

您的驅動程式在成功呼叫 WdfDeviceCreate 之後，不得呼叫 WdfDeviceInitFree。

WDFDEVICE_INIT結構可在 1.0 版和更新版本的 KMDF 中使用。

需求

頁首	Wdftypes.h （包括 Wdftypes.h）