MCI_FREEZE コマンド

MCI_FREEZE コマンドは、ディスプレイ上のモーションを固定します。デジタルビデオ、ビデオオーバーレイ、および VCR デバイスは、このコマンドを認識します。

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

パラメーター

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

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

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

MCI_DGV_FREEZE_AT: lpFreeze で識別される構造体の rc メンバーには、有効な四角形が含まれています。四角形は、各ピクセルのロックマスクビットがオンになるフレームバッファー内の領域を指定します。指定されたピクセルは、ロックマスクビットがオフになるまで更新されません。このフラグを指定しない場合、四角形は既定でフレームバッファー全体に設定されます。このフラグは、MCI_DGV_GETDEVCAPS_CAN_LOCK フラグに対して MCI_GETDEVCAPS コマンドが TRUE を 返す場合にのみサポートされます。
MCI_DGV_FREEZE_OUTSIDE: MCI_DGV_FREEZE_AT フラグに指定された領域の外側の領域は固定されます。

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

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

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

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

MCI_OVLY_RECT: lpFreeze で識別される構造体の rc メンバーには、有効な四角形が含まれています。このフラグを指定しない場合、デバイスドライバーはフレーム全体を固定します。

ビデオオーバーレイデバイスの場合、 lpFreeze パラメーターは MCI_OVLY_RECT_PARMS 構造体を指します。

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