MCI_STATUS コマンド

[アーティクル]
06/13/2023

注意

バイアスフリー通信 Microsoft は、多様で包含的な環境をサポートしています。このドキュメント内には、"slave" という単語への参照があります。 Microsoft の Bias-Free Communications スタイルガイドでは、これを除外語として認識しています。この文言は、現在コマンド内で使用されている文言として使用されます。一貫性を保つ目的で、このドキュメントにはこの単語が含まれています。コマンドでこの単語が変更されると、このドキュメントが配置されるように修正されます。

MCI_STATUS コマンドは、MCI デバイスに関する情報を取得します。すべてのデバイスでこのコマンドが認識されます。 lpStatus パラメーターによって識別される構造体の dwReturn メンバーに情報が返されます。

このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_STATUS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_STATUS_PARMS) lpStatus
);

パラメーター

wDeviceID: コマンドメッセージを受信する MCI デバイスのデバイス識別子。
dwFlags: MCI_NOTIFY、MCI_WAIT、またはデジタルビデオおよび VCR デバイスの場合は、MCI_TEST。これらのフラグの詳細については、「待機、通知、およびテストフラグ」を参照してください。
lpStatus: MCI_STATUS_PARMS構造体へのポインター。 (拡張コマンドセットを持つデバイスは、この構造体をデバイス固有の構造に置き換える場合があります)。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

次の追加の標準フラグとコマンド固有フラグは、MCI_STATUSをサポートするすべてのデバイスに適用されます。

MCI_STATUS_ITEM

lpStatus によって識別される構造体の dwItem メンバーに、取得する状態項目を指定する定数が含まれていることを指定します。次の定数は、構造体の dwReturn メンバーで返す状態項目を定義します。

MCI_STATUS_CURRENT_TRACK

dwReturn メンバーは、現在のトラック番号に設定されます。 MCI では、連続トラック番号が使用されます。

MCI_STATUS_LENGTH

dwReturn メンバーは、メディアの合計長に設定されます。

MCI_STATUS_MODE

dwReturn メンバーは、デバイスの現在のモードに設定されます。モードには、次のものが含まれます。

MCI_MODE_NOT_READY
MCI_MODE_PAUSE
MCI_MODE_PLAY
MCI_MODE_STOP
MCI_MODE_OPEN
MCI_MODE_RECORD
MCI_MODE_SEEK

MCI_STATUS_NUMBER_OF_TRACKS

dwReturn メンバーは、再生可能なトラックの合計数に設定されます。

MCI_STATUS_POSITION

dwReturn メンバーは現在の位置に設定されます。

MCI_STATUS_READY

デバイスの準備ができた場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_STATUS_TIME_FORMAT

dwReturn メンバーは、デバイスの現在の時刻形式に設定されます。時間形式は次のとおりです。

MCI_FORMAT_BYTES
MCI_FORMAT_FRAMES
MCI_FORMAT_HMS
MCI_FORMAT_MILLISECONDS
MCI_FORMAT_MSF
MCI_FORMAT_SAMPLES
MCI_FORMAT_TMSF

MCI_STATUS_START

メディアの開始位置を取得します。開始位置を取得するには、このフラグを MCI_STATUS_ITEM と組み合わせ、lpStatus で識別される構造体の dwItem メンバーをMCI_STATUS_POSITIONに設定します。

MCI_TRACK

lpStatus によって識別される構造体の dwTrack メンバーに状態追跡パラメーターが含まれていることを示します。このフラグは、MCI_STATUS_POSITIONまたはMCI_STATUS_LENGTH定数と共に使用する必要があります。 MCI_STATUS_POSITIONと共に使用すると、MCI_TRACKは指定したトラックの開始位置を取得します。MCI_STATUS_LENGTHと共に使用すると、MCI_TRACKは指定したトラックの長さを取得します。MCI では、連続トラック番号が使用されます。

cdaudio デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターにMCI_STATUS_ITEMが指定されている場合に lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_CDA_STATUS_TYPE_TRACK

dwReturn メンバーは、次のいずれかの値に設定されます。

MCI_CDA_TRACK_AUDIO
MCI_CDA_TRACK_OTHER

このフラグを使用するには、MCI_TRACK フラグを設定し、lpStatus によって識別される構造体の dwTrack メンバーに有効なトラック番号を含める必要があります。

MCI_STATUS_MEDIA_PRESENT

デバイスにメディアが挿入されている場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

digitalvideo デバイスの種類では、次の追加フラグが使用されます。

MCI_DGV_STATUS_DISKSPACE: lpStatus によって識別される構造体の lpstrDrive メンバーは、ディスクドライブ、または一部の実装ではパスを指定します。 MCI_STATUS コマンドは、lpStatus によって識別される構造体の dwReturn メンバーの MCI_RESERVE コマンドによって取得できるディスク領域の概算量を返します。ディスク領域は、現在の時刻形式の単位で測定されます。
MCI_DGV_STATUS_INPUT: lpStatus によって識別される構造体の dwItem メンバーによって指定された定数は、入力に適用されます。
MCI_DGV_STATUS_LEFT: lpStatus で識別される構造体の dwItem メンバーによって指定された定数は、左側のオーディオチャネルに適用されます。
MCI_DGV_STATUS_NOMINAL: lpStatus によって識別される構造体の dwItem メンバーによって指定された定数は、現在の値ではなく名目値を要求します。
MCI_DGV_STATUS_OUTPUT: lpStatus によって識別される構造体の dwItem メンバーによって指定された定数は、出力に適用されます。
MCI_DGV_STATUS_RECORD: MCI_DGV_STATUS_FRAME_RATE フラグに対して返されるフレームレートは、圧縮に使用されるレートです。
MCI_DGV_STATUS_REFERENCE: lpStatus によって識別される構造体の dwReturn メンバーは、dwReference メンバーで指定されたフレームの前にある最も近いキーフレームイメージを返します。
MCI_DGV_STATUS_RIGHT: lpStatus によって識別される構造体の dwItem メンバーによって指定された定数は、適切なオーディオチャネルに適用されます。

dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーの digitalvideo デバイスの種類で、次の定数が使用されます。

MCI_AVI_STATUS_AUDIO_BREAKS

dwReturn メンバーは、最後の AVI シーケンスのオーディオ部分が分割された回数を返します。システムは、デバイスドライバーにオーディオデータを書き込もうとするたびにオーディオ中断をカウントし、ドライバーが使用可能なすべてのデータを既に再生していることを検出します。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。

MCI_AVI_STATUS_FRAMES_SKIPPED

dwReturn メンバーは、最後の AVI シーケンスが再生されたときに描画されなかったフレームの数を返します。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。

MCI_AVI_STATUS_LAST_PLAY_SPEED

dwReturn メンバーは、最後の AVI シーケンスの実際の再生時間がターゲットの再生時間とどの程度一致したかを表す値を返します。値 1000 は、ターゲット時刻と実際の時刻が同じであることを示します。たとえば、値 2000 は、AVI シーケンスの再生に必要な 2 倍の時間がかかったことを示します。このフラグは、MCIAVI デジタルビデオドライバーによってのみ認識されます。

MCI_DGV_STATUS_AUDIO

dwReturn メンバーは、MCI_SET コマンドの最新のMCI_SET_AUDIO オプションに応じて、MCI_ONまたはMCI_OFFを返します。どちらか一方または両方のスピーカーが有効になっている場合はMCI_ONを返し、それ以外の場合はMCI_OFF返します。

MCI_DGV_STATUS_AUDIO_INPUT

dwReturn メンバーは、アナログオーディオ信号のおおよその瞬間オーディオレベルを返します。 1000 より大きい値は、クリッピングの歪みがあることを意味します。一部のデバイスでは、オーディオの録音中にのみこの値を決定できます。この状態値には、 MCI_SETまたは MCI_SETAUDIO コマンドが関連付けされません。この値は、波形オーディオコマンドのMCI_WAVE_STATUS_LEVELに関連していますが、正規化方法は異なります。

MCI_DGV_STATUS_AUDIO_RECORD

dwReturn メンバーは、MCI_SETAUDIO コマンドの MCI_DGV_SETAUDIO_RECORD フラグによって設定された状態を反映するMCI_ONまたはMCI_OFFを返します。

MCI_DGV_STATUS_AUDIO_SOURCE

dwReturn メンバーは、現在のオーディオデジタイザーソースを返します。

MCI_DGV_SETAUDIO_AVERAGE

左右のオーディオチャネルの平均を指定します。

MCI_DGV_SETAUDIO_LEFT

左側のオーディオチャネルを指定します。

MCI_DGV_SETAUDIO_RIGHT

適切なオーディオチャネルを指定します。

MCI_DGV_SETAUDIO_STEREO

ステレオを指定します。

MCI_DGV_STATUS_AUDIO_STREAM

dwReturn メンバーは、現在のオーディオストリーム番号を返します。

MCI_DGV_STATUS_AVGBYTESPERSEC

dwReturn メンバーは、記録に使用された 1 秒あたりの平均バイト数を返します。

MCI_DGV_STATUS_BASS

dwReturn メンバーは、現在のオーディオベースレベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_BITSPERPEL

dwReturn メンバーは、キャプチャまたは記録されたデータを保存するために使用されるピクセルあたりのビット数を返します。

MCI_DGV_STATUS_BITSPERSAMPLE

dwReturn メンバーは、デバイスが記録に使用するサンプルあたりのビット数を返します。これは、PCM 形式をサポートするデバイスにのみ適用されます。

MCI_DGV_STATUS_BLOCKALIGN

dwReturn メンバーは、入力波形の開始に対するデータブロックの配置を返します。

MCI_DGV_STATUS_BRIGHTNESS

dwReturn メンバーは、現在のビデオの明るさレベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_COLOR

dwReturn メンバーは、現在の色レベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_CONTRAST

dwReturn メンバーは、現在のコントラストレベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_FILEFORMAT

dwReturn メンバーは、記録または保存用の現在のファイル形式を返します。

MCI_DGV_STATUS_FILE_MODE

dwReturn メンバーは、ファイル操作の状態を返します。

MCI_DGV_FILE_MODE_EDITING

切り取り、コピー、削除、貼り付け、元に戻す操作中に返されます。

MCI_DGV_FILE_MODE_IDLE

ファイルが次の操作の準備ができたときに返されます。

MCI_DGV_FILE_MODE_LOADING

ファイルの読み込み中に返されます。

MCI_DGV_FILE_MODE_SAVING

ファイルの保存中に返されます。

MCI_DGV_STATUS_FILE_COMPLETION

dwReturn メンバーは、読み込み、保存、キャプチャ、切り取り、コピー、削除、貼り付け、または元に戻す操作が進行した推定パーセンテージを返します。 (アプリケーションはこれを使用して、進行状況を視覚的に示すことができます)。このフラグは、すべてのデジタルビデオデバイスでサポートされているわけではありません。

MCI_DGV_STATUS_FORWARD

デバイスの方向が前方であるか、デバイスが再生されていない場合、 dwReturn メンバーは TRUE を 返します。

MCI_DGV_STATUS_FRAME_RATE

dwReturn メンバーは、MCI_DGV_STATUS_NOMINAL、MCI_DGV_STATUS_RECORD、またはその両方と共に使用する必要があります。 MCI_DGV_STATUS_RECORDと共に使用すると、記録に使用されている現在のフレームレートが返されます。 MCI_DGV_STATUS_RECORDとMCI_DGV_STATUS_NOMINALの両方で使用すると、入力ビデオ信号に関連付けられた公称フレームレートが返されます。 MCI_DGV_STATUS_NOMINALと共に使用すると、ファイルに関連付けられている標準フレームレートが返されます。いずれの場合も、単位は 1 秒あたりのフレーム数に 1000 を乗算します。

MCI_DGV_STATUS_GAMMA

dwReturn メンバーは、現在のガンマ値を返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_HPAL

dwReturn メンバーは、現在のパレットハンドルの ASCII 10 進値を返します。ハンドルは、戻り値の下位ワードに含まれています。

MCI_DGV_STATUS_HWND

dwReturn メンバーは、このデバイスドライバーインスタンスに関連付けられている現在の明示的または既定のウィンドウハンドルの ASCII 10 進値を返します。ハンドルは、戻り値の下位ワードに含まれています。

MCI_DGV_STATUS_KEY_COLOR

dwReturn メンバーは、現在のキーと色の値を返します。

MCI_DGV_STATUS_KEY_INDEX

dwReturn メンバーは、現在のキーインデックス値を返します。

MCI_DGV_STATUS_MONITOR

dwReturn メンバーは、現在のプレゼンテーションのソースを示す定数を返します。次の定数が定義されています。

MCI_DGV_MONITOR_FILE

ファイルがソースです。

MCI_DGV_MONITOR_INPUT

入力はソースです。

MCI_DGV_STATUS_MONITOR_METHOD

dwReturn メンバーは、入力監視に使用されるメソッドを示す定数を返します。次の定数が定義されています。

MCI_DGV_METHOD_DIRECT

直接入力の監視。

MCI_DGV_METHOD_POST

入力後の監視。

MCI_DGV_METHOD_PRE

入力前の監視。

MCI_DGV_STATUS_PAUSE_MODE

dwReturn メンバーは、再生中にデバイスが一時停止された場合はMCI_MODE_PLAYを返し、記録中にデバイスが一時停止された場合はMCI_MODE_RECORDを返します。このコマンドは、デバイスが一時停止されていない場合にエラーとしてMCIERR_NONAPPLICABLE_FUNCTIONを返します。

MCI_DGV_STATUS_SAMPLESPERSECOND

dwReturn メンバーは、記録された 1 秒あたりのサンプル数を返します。

MCI_DGV_STATUS_SEEK_EXACTLY

dwReturn メンバーは、シークの正確な形式が設定されているかどうかを示す TRUE または FALSE を返します。 (アプリケーションでは、MCI_DGV_SET_SEEK_EXACTLY フラグと共に MCI_SET コマンドを使用して、この形式を設定できます。

MCI_DGV_STATUS_SHARPNESS

dwReturn メンバーは、現在のシャープネスレベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_SIZE

dwReturn メンバーは、予約済みワークスペースが保持する圧縮データのおおよその再生時間を返します。期間の単位は、現在の時刻形式です。予約済みのディスク領域がない場合は、0 を返します。圧縮されたデータの正確なディスク領域は、一般に、データが圧縮されるまで予測できないため、返されるサイズは概算です。

MCI_DGV_STATUS_SMPTE

dwReturn メンバーは、ワークスペース内の現在の位置に関連付けられている SMPTE 時間コードを返します。

MCI_DGV_STATUS_SPEED

dwReturn メンバーは、現在の再生速度を返します。

MCI_DGV_STATUS_STILL_FILEFORMAT

dwReturn メンバーは、MCI_CAPTURE コマンドの現在のファイル形式を返します。

MCI_DGV_STATUS_TINT

dwReturn メンバーは、現在のビデオの濃淡レベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_TREBLE

dwReturn メンバーは、現在のオーディオトレブルレベルを返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_UNSAVED

dwReturn メンバーは、MCI_CLOSE、MCI_LOAD、MCI_RECORD、MCI_RESERVE、MCI_CUT、MCI_DELETE 、または MCI_PASTE コマンドの結果として失われる可能性がある記録されたデータがワークスペースに存在する場合にTRUE を返します。それ以外の場合、メンバーは FALSE を 返します。

MCI_DGV_STATUS_VIDEO

dwReturn メンバーは、ビデオが有効な場合はMCI_ON、無効になっている場合はMCI_OFFを返します。

MCI_DGV_STATUS_VIDEO_RECORD

dwReturn メンバーは、MCI_SETVIDEO コマンドの MCI_DGV_SETVIDEO_RECORD フラグによって設定された状態を反映して、MCI_ONまたはMCI_OFFを返します。

MCI_DGV_STATUS_VIDEO_SOURCE

dwReturn メンバーは、MCI_SETVIDEO コマンドの MCI_DGV_SETVIDEO_SOURCE フラグによって設定されたビデオソースの種類を示す定数を返します。

MCI_DGV_STATUS_VIDEO_SRC_NUM

dwReturn メンバーは、現在アクティブなビデオ入力ソースの型内の数値を返します。

MCI_DGV_STATUS_VIDEO_STREAM

dwReturn メンバーは、現在のビデオストリーム番号を返します。

MCI_DGV_STATUS_VOLUME

dwReturn メンバーは、ボリュームの平均を左右のスピーカーに返します。標準レベルを取得するには、このフラグで MCI_DGV_STATUS_NOMINAL を使用します。

MCI_DGV_STATUS_WINDOW_VISIBLE

ウィンドウが非表示でない場合、 dwReturn メンバーは TRUE を 返します。

MCI_DGV_STATUS_WINDOW_MINIMIZED

ウィンドウが最小化されている場合、 dwReturn メンバーは TRUE を 返します。

MCI_DGV_STATUS_WINDOW_MAXIMIZED

ウィンドウが最大化されている場合、 dwReturn メンバーは TRUE を 返します。

MCI_STATUS_MEDIA_PRESENT

dwReturn メンバーは TRUE を返します。

デジタルビデオデバイスの場合、 lpStatus パラメーターは MCI_DGV_STATUS_PARMS 構造体を指します。

シー ケンサー デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_SEQ_STATUS_DIVTYPE

dwReturn メンバーは、シーケンスの現在の除算の種類を示す次のいずれかの値に設定されます。

MCI_SEQ_DIV_PPQN
MCI_SEQ_DIV_SMPTE_24
MCI_SEQ_DIV_SMPTE_25
MCI_SEQ_DIV_SMPTE_30
MCI_SEQ_DIV_SMPTE_30DROP

MCI_SEQ_STATUS_MASTER

dwReturn メンバーは、マスター操作に使用される同期の種類に設定されます。

MCI_SEQ_STATUS_OFFSET

dwReturn メンバーは、シーケンスの現在の SMPTE オフセットに設定されます。

MCI_SEQ_STATUS_PORT

dwReturn メンバーは、シーケンスで使用されている現在のポートの MIDI デバイス識別子に設定されます。

MCI_SEQ_STATUS_SLAVE

dwReturn メンバーは、下位操作に使用される同期の種類に設定されます。

MCI_SEQ_STATUS_TEMPO

dwReturn メンバーは、PPQN ファイルの場合は 1 分あたりのビート数、SMPTE ファイルの場合は 1 秒あたりのフレーム数で MIDI シーケンスの現在のテンポに設定されます。

MCI_STATUS_MEDIA_PRESENT

メディアがデバイスに挿入された場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

vcr デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_STATUS_MEDIA_PRESENT

メディアがデバイスに挿入された場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_ASSEMBLE_RECORD

アセンブルモードがオンの場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_AUDIO_MONITOR

dwReturn メンバーは、現在選択されているオーディオモニターの種類を示す定数に設定されます。

MCI_VCR_STATUS_AUDIO_MONITOR_NUMBER

dwReturn メンバーは、現在選択されているオーディオモニターの種類の番号に設定されます。

MCI_VCR_STATUS_AUDIO_RECORD

次の record コマンドが指定されたときにオーディオが記録される場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。このコマンドの dwFlags パラメーターにMCI_TRACKを指定した場合、 dwTrack には、この照会が適用されるトラックが含まれます。

MCI_VCR_STATUS_AUDIO_SOURCE

dwReturn メンバーは、現在のオーディオソースの種類を示す定数に設定されます。

MCI_VCR_STATUS_AUDIO_SOURCE_NUMBER

dwReturn メンバーは、現在選択されているオーディオソースの種類の番号に設定されます。

MCI_VCR_STATUS_CLOCK

dwReturn メンバーは、合計クロック増分で現在のクロック値に設定されます。

MCI_VCR_STATUS_CLOCK_ID

dwReturn メンバーは、使用中のクロックを一意に記述する数値に設定されます。

MCI_VCR_STATUS_COUNTER_FORMAT

dwReturn メンバーは、現在のカウンター形式を記述する定数に設定されます。詳細については、 MCI_SET コマンドの MCI_SET_TIME_FORMAT フラグを参照してください。

MCI_VCR_STATUS_COUNTER_RESOLUTION

dwReturn メンバーは、カウンターの解決を記述する定数に設定され、次のいずれかの値です。

MCI_VCR_COUNTER_RES_FRAMES: カウンターにはフレームの解像度があります。
MCI_VCR_COUNTER_RES_SECONDS: カウンターの解像度は秒です。
MCI_VCR_STATUS_COUNTER_VALUE: dwReturn メンバーは、現在のカウンタータイム形式で現在のカウンター読み取りに設定されます。

MCI_VCR_STATUS_FRAME_RATE

dwReturn メンバーは、デバイスの現在のネイティブフレームレートに設定されます。

MCI_VCR_STATUS_INDEX

dwReturn メンバーは、画面上のディスプレイの現在の内容を記述する定数に設定され、次のいずれかです。

MCI_VCR_INDEX_COUNTER
MCI_VCR_INDEX_DATE
MCI_VCR_INDEX_TIME
MCI_VCR_INDEX_TIMECODE

MCI_VCR_STATUS_INDEX_ON

画面上の表示がオンの場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_MEDIA_TYPE

dwReturn メンバーは、次のいずれかに設定されます。

MCI_VCR_MEDIA_8MM
MCI_VCR_MEDIA_HI8
MCI_VCR_MEDIA_VHS
MCI_VCR_MEDIA_SVHS
MCI_VCR_MEDIA_BETA
MCI_VCR_MEDIA_EDBETA
MCI_VCR_MEDIA_OTHER

MCI_VCR_STATUS_NUMBER

このフラグを MCI_VCR_STATUS_TUNER_CHANNEL フラグと共に使用すると、 dwNumber メンバーは論理チューナー番号に設定されます。

MCI_VCR_STATUS_NUMBER_OF_AUDIO_TRACKS

dwReturn メンバーは、個別に選択可能なオーディオトラックの数に設定されます。

MCI_VCR_STATUS_NUMBER_OF_VIDEO_TRACKS

dwReturn メンバーは、個別に選択可能なビデオトラックの数に設定されます。

MCI_VCR_STATUS_PAUSE_TIMEOUT

dwReturn メンバーは、一時停止コマンドの最大期間 (ミリ秒単位) に設定されます。戻り値が 0 の場合、タイムアウトは発生しません。

MCI_VCR_STATUS_PLAY_FORMAT

dwReturn メンバーは、次のいずれかに設定されます。

MCI_VCR_FORMAT_EP
MCI_VCR_FORMAT_LP
MCI_VCR_FORMAT_OTHER
MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_POSTROLL_DURATION

dwReturn メンバーは、現在の時刻形式で、停止したスポットの後で再生される videotape の長さに設定されます。これは、停止または一時停止コマンドから VCR テープ転送をブレーキするために必要です。

MCI_VCR_STATUS_POWER_ON

電源がオンの場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_PREROLL_DURATION

dwReturn メンバーは、開始されたスポットの前に再生される videotape の長さに現在の時刻形式で設定されます。これは、VCR 出力を安定させるために必要です。

MCI_VCR_STATUS_RECORD_FORMAT

dwReturn メンバーは、次のいずれかに設定されます。

MCI_VCR_FORMAT_EP
MCI_VCR_FORMAT_LP
MCI_VCR_FORMAT_OTHER
MCI_VCR_FORMAT_SP

MCI_VCR_STATUS_SPEED

dwReturn メンバーは現在の速度に設定されます。詳細については、 MCI_SET コマンドの MCI_VCR_SET_SPEED フラグを参照してください。

MCI_VCR_STATUS_TIME_MODE

dwReturn メンバーは、次のいずれかに設定されます。

MCI_VCR_TIME_COUNTER
MCI_VCR_TIME_DETECT
MCI_VCR_TIME_TIMECODE

詳細については、 MCI_SET コマンドの MCI_VCR_SET_TIME_MODE フラグを参照してください。

MCI_VCR_STATUS_TIME_TYPE

dwReturn メンバーは、使用中の現在の時刻の種類 (play、record、seek などによって使用) を記述する定数に設定され、次のいずれかになります。

MCI_VCR_TIME_COUNTER

カウンターが使用されています。

MCI_VCR_TIME_TIMECODE

タイムコードが使用されています。

MCI_VCR_STATUS_TIMECODE_PRESENT

タイムコードがコンテンツ内の現在の位置に存在する場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_TIMECODE_RECORD

次の record コマンドが指定されたときにタイムコードが記録される場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。

MCI_VCR_STATUS_TIMECODE_TYPE

dwReturn メンバーは定数に設定され、デバイスで直接サポートされているタイムコードの種類を記述します。これは次のいずれかです。

MCI_VCR_TIMECODE_TYPE_NONE: このデバイスはタイムコードを使用しません。
MCI_VCR_TIMECODE_TYPE_OTHER: このデバイスでは、指定されていないタイムコードが使用されます。
MCI_VCR_TIMECODE_TYPE_SMPTE: このデバイスは SMPTE タイムコードを使用します。
MCI_VCR_TIMECODE_TYPE_SMPTE_DROP: このデバイスは SMPTE ドロップタイムコードを使用します。

MCI_VCR_STATUS_TUNER_CHANNEL

dwReturn メンバーは、現在のチャネル番号に設定されます。このコマンドの dwFlags パラメーターにMCI_VCR_STATUS_NUMBERを指定した場合、 dwNumber には、このコマンドが適用される論理チューナー番号が含まれます。

MCI_VCR_STATUS_VIDEO_MONITOR

dwReturn メンバーは、現在選択されているビデオモニターの種類を示す定数に設定されます。

MCI_VCR_STATUS_VIDEO_MONITOR_NUMBER

dwReturn メンバーは、現在選択されているビデオモニターの種類の番号に設定されます。

MCI_VCR_STATUS_VIDEO_RECORD

次の record コマンドが指定されたときにビデオが記録される場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。このコマンドの dwFlags パラメーターにMCI_TRACKを指定した場合、 dwTrack には、この照会が適用されるトラックが含まれます。

MCI_VCR_STATUS_VIDEO_SOURCE

dwReturn メンバーは、現在選択されているビデオソースの種類を示す定数に設定されます。

MCI_VCR_STATUS_VIDEO_SOURCE_NUMBER

dwReturn メンバーは、現在選択されているビデオソースの種類の番号に設定されます。

MCI_VCR_STATUS_WRITE_PROTECTED

メディアが書き込み保護されている場合、 dwReturn メンバーは TRUE に 設定されます。それ以外の場合は FALSE に設定されます。

VCR デバイスの場合、 lpStatus パラメーターは MCI_VCR_STATUS_PARMS 構造体を指します。

MCI_STATUS_LENGTH フラグを使用してメディアの長さを確認すると、 MCI_SET コマンドを使用して長さが明示的に変更されていない限り、VCR デバイスでは常に 2 時間が返されます。

オーバーレイ デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_OVLY_STATUS_HWND: dwReturn メンバーは、ビデオオーバーレイデバイスに関連付けられているウィンドウのハンドルに設定されます。
MCI_OVLY_STATUS_STRETCH: ストレッチが有効になっている場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。
MCI_STATUS_MEDIA_PRESENT: メディアがデバイスに挿入された場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

videodisc デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_STATUS_MEDIA_PRESENT

メディアがデバイスに挿入された場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI_STATUS_MODE

dwReturn メンバーは、デバイスの現在のモードに設定されます。 videodisc デバイスは、 dwFlags パラメーターに記載されているように、任意のデバイスが返すことができる定数に加えて、MCI_VD_MODE_PARK定数を返すことができます。

MCI_VD_STATUS_DISC_SIZE

dwReturn メンバーは、読み込まれたディスクのサイズをインチ (8 または 12) で設定します。

MCI_VD_STATUS_FORWARD

前方に再生する場合、 dwReturn メンバーは TRUE に設定されます。それ以外の場合は FALSE に設定されます。

MCI videodisc デバイスでは、このフラグはサポートされていません。

MCI_VD_STATUS_MEDIA_TYPE

dwReturn メンバーは、挿入されたメディアのメディアの種類に設定されます。次のメディアの種類を返すことができます。

MCI_VD_MEDIA_CAV

MCI_VD_MEDIA_CLV

MCI_VD_MEDIA_OTHER

MCI_VD_STATUS_SIDE

dwReturn メンバーは、ディスクの読み込み側を示すために 1 または 2 に設定されます。すべての videodisc デバイスがこのフラグをサポートしているわけではありません。

MCI_VD_STATUS_SPEED

dwReturn メンバーは、1 秒あたりのフレーム数で再生速度に設定されます。 MCIPIONR。DRV デバイスドライバーは、MCIERR_UNSUPPORTED_FUNCTIONを返します。

waveaudio デバイスの種類では、次の追加フラグが使用されます。これらの定数は、dwFlags パラメーターに対して MCI_STATUS_ITEMが指定されている場合、lpStatus パラメーターによって指される構造体の dwItem メンバーで使用されます。

MCI_WAVE_FORMATTAG: dwReturn メンバーは、再生、記録、保存に使用される現在の形式タグに設定されます。
MCI_WAVE_INPUT: dwReturn メンバーは、記録に使用されるウェーブ入力デバイスに設定されます。使用中のデバイスがなく、デバイスが明示的に設定されていない場合、エラーの戻り値はMCIERR_WAVE_INPUTUNSPECIFIED。
MCI_WAVE_OUTPUT: dwReturn メンバーは、再生に使用されるウェーブ出力デバイスに設定されます。使用中のデバイスがなく、デバイスが明示的に設定されていない場合、エラーの戻り値はMCIERR_WAVE_OUTPUTUNSPECIFIED。
MCI_WAVE_STATUS_AVGBYTESPERSEC: dwReturn メンバーは、再生、記録、保存に使用される 1 秒あたりの現在のバイト数に設定されます。
MCI_WAVE_STATUS_BITSPERSAMPLE: dwReturn メンバーは、PCM 形式のデータの再生、記録、保存に使用されるサンプルごとの現在のビットに設定されます。
MCI_WAVE_STATUS_BLOCKALIGN: dwReturn メンバーは、再生、記録、保存に使用される現在のブロックアラインメントに設定されます。
MCI_WAVE_STATUS_CHANNELS: dwReturn メンバーは、再生、記録、保存に使用される現在のチャネル数に設定されます。
MCI_WAVE_STATUS_LEVEL: dwReturn メンバーは、PCM 形式のデータの現在のレコードまたは再生レベルに設定されます。値は、使用されるサンプルサイズに応じて、8 ビットまたは 16 ビットの値として返されます。右またはモノのチャネルレベルは、下位ワードで返されます。左側のチャネルレベルは、上位ワードで返されます。
MCI_WAVE_STATUS_SAMPLESPERSEC: dwReturn メンバーは、再生、記録、保存に使用される 1 秒あたりの現在のサンプルに設定されます。

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Mmsystem.h (Windows.h を含む)

次の方法で共有

MCI_STATUS コマンド

パラメーター

戻り値

解説

必要条件

関連項目

フィードバック

その他のリソース