window 命令
視窗命令會控制顯示視窗。 您可以使用此命令來變更視窗的顯示特性,或提供目的地視窗,讓驅動程式用來取代預設顯示視窗。 數位視訊和視訊重迭裝置可辨識此命令。
若要傳送此命令,請使用lpszCommand參數集呼叫mciSendString函式,如下所示。
_stprintf_s(
lpszCommand,
TEXT("window %s %s %s"),
lpszDeviceID,
lpszWindowFlags,
lpszFlags
);
參數
-
lpszDeviceID
-
MCI 裝置的識別碼。 開啟裝置時,會指派此識別碼或別名。
-
lpszWindowFlags
-
用於控制顯示視窗的旗標。 下表列出可辨識視窗命令的裝置類型,以及每種類型所使用的旗標。
值 意義 意義 digitalvideo handle hwnd state hidestate minimizestate restorestate 顯示最大化 show minimizedshow min noactiveshow nashow noactivateshow normaltext標題 overlay fixedhandle defaulthandle hwnd state hidestate 圖示state maximizedstate minimizestate minimizedstate no actionstate noactivatestate normal state restorestate 顯示最大化顯示顯示最小化顯示min noactiveshow nashow noactivateshow normalstretchtext標題 下表列出可在 lpszWindowFlags 參數及其意義中指定的旗標。
值 意義 fixed 停用影像的延展。 handle default 指定裝置應該將顯示視窗設定回 開啟 作業期間建立的預設視窗。 針對視訊重迭裝置,指定裝置應該建立和管理自己的目的地視窗。 handle hwnd 指定要使用的目的地視窗控制碼,而不是預設視窗。 hwnd參數包含 ASCII 數值,相當於CreateWindow函式所傳回的視窗控制碼。 兩個裝置實例可以使用相同的視窗控制碼,前提是每個實例都會更新視窗中的視訊和影像圖元,就像其他實例不存在一樣。 使用 setvideo 「off」 停用視訊輸出時, 更新 命令會將目的地矩形設為純色。 顯示最大化 最大化目的地視窗。 顯示 最小 noactive 將目的地視窗顯示為圖示。 顯示最小化 將目的地視窗最小化。 顯示 na 以目前狀態顯示目的地視窗;目前使用中的視窗會維持使用中狀態。 顯示 noactivate 在最近的大小和位置中顯示目的地視窗;目前使用中的視窗會維持使用中狀態。 顯示正常 啟動並顯示其原始大小和位置的目的地視窗。 (這與「狀態還原」旗標相同。) 狀態隱藏 隱藏目的地視窗。 州圖示 將目的地視窗顯示為圖示。 狀態最大化 最大化目的地視窗。 狀態最小化 將目的地視窗最小化,並啟動視窗管理員清單中的最上層視窗。 狀態最小化 將目的地視窗最小化。 狀態無動作 以目前狀態顯示目的地視窗。 目前使用中的視窗會維持使用中狀態。 state noactivate 以最新的大小和狀態顯示目的地視窗。 使用中視窗還是維持作用中的狀態。 狀態正常 啟動並顯示其原始大小和位置的目的地視窗。 狀態還原 啟動並顯示其原始大小和位置的目的地視窗。 狀態顯示 顯示目的地視窗。 Stretch - 自動縮放 啟用影像的延展。 text標題 指定目的地視窗的標題。 如果此文字包含內嵌的空白,則必須以引號括住整個標題。 預設視窗的預設標題為空白。 -
lpszFlags
-
可以是 「wait」、「notify」 或兩者。 對於數位視訊裝置,也可以指定「測試」。 如需這些旗標的詳細資訊,請參閱 等候、通知和測試旗標。
傳回值
如果成功或發生錯誤,則傳回零。
備註
視訊重迭裝置通常會在開啟時建立和顯示視窗。 如果您的應用程式提供視窗給驅動程式,您的應用程式會負責管理傳送至視窗的訊息。
因為您可以使用 status 命令來擷取驅動程式顯示視窗的控制碼,所以您也可以使用標準視窗管理員函式 (,例如 ShowWindow) 來操作視窗。
範例
下列命令會顯示並設定 「電影」播放視窗的標題。
window movie text "Welcome to the Movies" state show
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |