GetFrame 関数

GetFrame 関数は、キャプチャ内の特定のフレームにハンドルを返します。

構文

HFRAME WINAPI GetFrame(
  _In_ HCAPTURE hCapture,
  _In_ DWORD    FrameNumber
);

パラメーター

hCapture [in]

キャプチャへのハンドル。 キャプチャ ハンドルを取得するには、 GetFrameCaptureHandle 関数を呼び出します。

FrameNumber [in]

フレームの数値 (0 から始まる)。 キャプチャ内の最初のフレームの数は 0 です。

戻り値

関数が成功した場合、戻り値はフレームへのハンドルです。

関数が失敗した場合 (つまり、 hCapture が無効な場合、またはフレーム番号が範囲外の場合)、戻り値は NULL です。

解説

GetFrame 関数を使用して、プロパティのインスタンスを検索するときに必要なフレーム ハンドルを取得します。 プロパティ インスタンスの検索に使用される関数は、最初のインスタンスを検索する FindPropertyInstance と、次のインスタンスを検索する FindPropertyInstanceRestart です。

エキスパートとパーサーは、GetFrame 関数を呼び出すことができます。

必要条件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Netmon.h
ライブラリ	Nmapi.lib
[DLL]	Nmapi.dll

関連項目

FindPropertyInstance

FindPropertyInstanceRestart