GetCaptureComment 関数
GetCaptureComment 関数は、キャプチャのコメントへのポインターを返します。
構文
LPSTR WINAPI GetCaptureComment(
_In_ HCAPTURE hCapture
);
パラメーター
-
hCapture [in]
-
キャプチャのハンドル。 キャプチャ ハンドルの取得の詳細については、「解説」セクションを参照してください。
戻り値
関数が成功した場合 (つまり、キャプチャにコメントが含まれている場合)、戻り値はコメント文字列へのポインターです。
関数が失敗した場合、戻り値は NULL です。
解説
読み込まれたキャプチャ内の実際のコメント文字列である、返されるコメント文字列を変更しないでください。 変更を加えると、キャプチャが破損する可能性があります。 文字列を変更しようとすると、アクセス違反が発生します。
キャプチャのハンドルは、エキスパートまたはパーサーによって呼び出しが行われたかどうかに応じて、いくつかの方法で取得できます。 エキスパートの場合、ハンドルは EXPERTSTARTUPINFO 構造体の hCapture メンバーで指定されます。 パーサーの場合、キャプチャ ハンドルは GetFrameCaptureHandle 関数を呼び出すことによって取得できます。
キャプチャ ファイルからキャプチャのコメントを取得するには、 GetCaptureCommentFromFilename 関数を呼び出します。
エキスパートとパーサーは、GetCaptureComment 関数を呼び出すことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|