IMDSPStorage2：：GetStorage 方法 (mswmdm.h)

GetStorage 方法可讓您直接從記憶體名稱移至記憶體物件，而不是列舉所有記憶體來尋找它。

語法

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

參數

[in] pszStorageName

包含記憶體名稱之 Null 終止字串的指標。

[out] ppStorage

pszStorageName 所指定的記憶體物件的指標，如果找不到這類記憶體，則為 NULL。

傳回值

方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別：

• 標準 COM 錯誤碼
• 轉換成 HRESULT 值的 Windows 錯誤碼
• Windows Media 裝置管理員 錯誤碼

備註

IMDSPStorage2：：GetStorage 介面會擴充 IMDSPStorage 的功能。

IMDSPStorage2：：GetStorage 不支援通配符。 它不是遞歸的，也就是說，它只會在目前的記憶體中找到儲存物件。

如果未實作這個方法，它應該會傳回E_NOTIMPL。 (它不應該傳回WMDM_E_NOT_SUPPORTED或任何其他程序代碼，指出此方法未實作) 。 這可確保 Windows Media 裝置管理員 會藉由列舉所有記憶體，根據以 pszStorageName 傳入的記憶體名稱來尋找相符專案，以嘗試取代此功能本身。

強烈建議服務提供者實作這個方法，以根據名稱有效率地傳回記憶體物件。

這個方法是一個選擇項目。 如需詳細資訊，請參閱 強制和選擇性介面。

規格需求

另請參閱

IMDSPStorage 介面

IMDSPStorage2 介面