MCI_SEEK コマンド
MCI_SEEK コマンドは、コンテンツ内の現在の位置をできるだけ早く変更します。 シーク中にビデオとオーディオの出力が無効になります。 シークが完了すると、デバイスが停止します。 CD オーディオ、デジタル ビデオ、MIDI シーケンサー、VCR、videodisc、波形オーディオ デバイスは、このコマンドを認識します。
このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SEEK,
DWORD dwFlags,
(DWORD) (LPMCI_SEEK_PARMS) lpSeek
);
パラメーター
-
wDeviceID
-
コマンド メッセージを受信する MCI デバイスのデバイス識別子。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT、またはデジタル ビデオおよび VCR デバイスの場合は、MCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
-
lpSeek
-
MCI_SEEK_PARMS構造体へのポインター。 (拡張コマンド セットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
注釈
デバイスのデータ サンプル サイズが 1 バイトを超える場合 (波形オーディオ ステレオ データなど)、指定した位置がサンプルの先頭と一致しない場合、このコマンドは最も近いサンプルの先頭に移動します。
次の追加フラグは、MCI_SEEKをサポートするすべてのデバイスに適用されます。
-
MCI_SEEK_TO_END
-
コンテンツの最後までシークします。
-
MCI_SEEK_TO_START
-
コンテンツの先頭に移動します。
-
MCI_TO
-
位置は、lpSeek によって識別される構造体の dwTo メンバーに含まれます。 位置の値に割り当てられる単位は、 MCI_SET コマンドのMCI_SET_TIME_FORMAT フラグで指定されます。 このフラグは、MCI_SEEK_TO_ENDまたはMCI_SEEK_TO_STARTでは使用しないでください。
vcr デバイスの種類では、次の追加フラグが使用されます。
-
MCI_VCR_SEEK_AT
-
lpSeek によって識別される構造体の dwAt メンバーには、コマンド全体が開始される時刻が含まれます。
-
MCI_VCR_SEEK_MARK
-
lpSeek によって識別される構造体の dwMark メンバーには、検索する番号付きマークが含まれています。
-
MCI_VCR_SEEK_REVERSE
-
シーク方向は逆です。これは、MCI_VCR_SEEK_MARK フラグでのみ使用されます。
VCR デバイスの場合、 lpSeek パラメーターは MCI_VCR_SEEK_PARMS 構造体を指します。
videodisc デバイスの種類では、次の追加フラグが使用されます。
-
MCI_VD_SEEK_REVERSE
-
シーク方向は逆です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|