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 デバイスの種類では、次の追加フラグが使用されます。
-
MCI_VCR_FREEZE_FIELD
-
現在のフレームのメンバーを 1 つだけ固定します。
-
MCI_VCR_FREEZE_FRAME
-
現在のフレームの両方のフィールドを固定します。
-
MCI_VCR_FREEZE_INPUT
-
画面上の現在のフレームを固定します (記録に使用されます)。
-
MCI_VCR_FREEZE_OUTPUT
-
VCR (フレーム キャプチャで使用) から現在のフレームを固定します。
VCR デバイスの場合、 lpFreeze パラメーターは MCI_GENERIC_PARMS 構造体を指します。
オーバーレイ デバイスの種類では、次の追加フラグが使用されます。
-
MCI_OVLY_RECT
-
lpFreeze で識別される構造体の rc メンバーには、有効な四角形が含まれています。 このフラグを指定しない場合、デバイス ドライバーはフレーム全体を固定します。
ビデオ オーバーレイ デバイスの場合、 lpFreeze パラメーターは MCI_OVLY_RECT_PARMS 構造体を指します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|