CdromCollection.getByDriveSpecifier 方法

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

getByDriveSpecifier方法會擷取與特定磁碟機號相關聯的Cdrom物件。

語法

retVal = CdromCollection.getByDriveSpecifier(
  driveSpecifier
)

參數

driveSpecifier [in]

包含 磁碟機號的字串,後面接著冒號 (「:」) 字元。

傳回值

這個方法會傳回 Cdrom 物件。

備註

必須以 X:格式提供磁碟機號,其中 X 代表磁碟機號。

若要使用此方法,需要程式庫的讀取權限。 如需詳細資訊,請參閱 程式庫存取

Windows 媒體播放機 10 行動裝置版:不支援此方法。

範例

下列 JScript 範例使用 CdromCollectiongetByDriveSpecifier 可擷取對應至使用者所提供的磁碟機號的 Cdrom 物件。 已建立 HTML 文字元素,並針對使用者輸入使用 NAME = 「MyText」。 Player物件是以識別碼 = 「Player」 建立的。

// Store the drive letter provided by the user.
var DriveLetter = MyText.value;

// Append a colon to the drive letter to create a valid drive specifier.
DriveLetter += ":";

// Get the Cdrom object using the drive specifier.
var Drive = Player.cdRomCollection.getByDriveSpecifier(DriveLetter);

// Use the Cdrom object to open the drive door.
Drive.eject();

規格需求

需求
版本
Windows 媒體播放機 7.0 版或更新版本。
DLL
Wmp.dll

另請參閱

Cdrom 物件

Cdrom.退出

CdromCollection 物件

Settings.mediaAccessRights

Settings.requestMediaAccessRights