IMDServiceProvider2：：CreateDevice 方法 (mswmdm.h)

Windows Media 裝置管理員 會呼叫 CreateDevice 方法，以取得 IMDSPDevice 物件 (s) 對應至從 PnP 子系統取得的標準裝置。 這個方法必須針對 PnP 和 Windows 檔案總管支援實作，否則為選擇性。 如需詳細資訊，請參閱 強制和選擇性介面。

語法

HRESULT CreateDevice(
  [in]  LPCWSTR     pwszDevicePath,
  [out] DWORD       *pdwCount,
  [out] IMDSPDevice ***pppDeviceArray
);

參數

[in] pwszDevicePath

寬字元 Null 終止字串的指標，其中包含 Windows Media 裝置管理員 偵測到之裝置的裝置路徑。 此名稱是從 PnP 子系統取得，而是標準名稱加上 “$ # ”，其中 # 是自動遞增的數位。 此名稱可以直接傳遞至 CreateFile 之類的函式，以取得基礎核心裝置物件的存取權。 服務提供者應該為此裝置建立包裝函式 IMDSPDevice 物件 (s) 。

[out] pdwCount

DWORD 的指標，其中包含所建立的 IMDSPDevice 物件數目。

[out] pppDeviceArray

代表裝置的 IMDSPDevice 介面陣列。 一般而言，只有一個數位元素，但如果服務提供者為每個最上層記憶體建立 IMDSPDevice 物件，則可以建立一個以上的 IMDSPDevice 物件，以對應到裝置路徑名稱。 這可能會在未來變更，而且計數可能會限製為1。

傳回值

如果方法成功，它會傳回S_OK。 如果方法失敗，它會傳回 Windows Media 裝置管理員 錯誤碼。

備註

Windows Media 裝置管理員 應用程式啟動時或 隨插即用 相容裝置與電腦連線時呼叫此方法。

規格需求

另請參閱

列舉裝置

IMDServiceProvider2 介面