load コマンド
load コマンドは、デバイス固有の形式でファイルを読み込みます。 デジタル ビデオおよびビデオ オーバーレイ デバイスは、このコマンドを認識します。
このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。
_stprintf_s(
lpszCommand,
TEXT("load %s %s %s"),
lpszDeviceID,
lpszFilePos,
lpszFlags
);
パラメーター
-
lpszDeviceID
-
MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。
-
lpszFilePos
-
読み込むパスとファイル名。 ビデオ オーバーレイ デバイスの場合、これにはデータのターゲット四角形を含めることもできます。 ターゲットの四角形を指定するには、"at" の後に X1 Y1 X2 Y2 を指定します。 X1 Y1 は四角形の左上隅を指定し、 X2 Y2 は幅と高さを指定します。 四角形は、ビデオ バッファーの原点を基準にしています。
-
lpszFlags
-
"wait"、"notify"、またはその両方を指定できます。 デジタル ビデオ デバイスの場合は、"テスト" を指定することもできます。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。
戻り値
成功した場合は 0 を返し、それ以外の場合はエラーを返します。
解説
"vidboard" デバイスは、読み込みが完了したときに通知メッセージを送信します。
例
次のコマンドは、"vidboard" デバイスにファイルを読み込みます。
load vidboard c:\vid\fish.vid notify
必要条件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |