IMFSensorDevice::GetSymbolicLink メソッド (mfidl.h)
センサー デバイスのシンボリック リンク名を取得します。
構文
HRESULT GetSymbolicLink(
[out] LPWSTR SymbolicLink,
[in] LONG cchSymbolicLink,
[out] LONG *pcchWritten
);
パラメーター
[out] SymbolicLink
シンボリック リンク名が書き込まれる cchSymbolicLink 文字のバッファー。 バッファーは、null ターミネータを考慮するのに十分な大きさである必要があります。
[in] cchSymbolicLink
SymbolicLink バッファーで使用できる文字数。
[out] pcchWritten
SymbolicLink に書き込まれた文字数を含む出力パラメーター。 これには、null ターミネータが含まれます。 SymbolicLink が null で、cchSymbolicLink が 0 の場合、pcchWritten にはシンボリック リンク名を格納するために必要な文字数 (null ターミネータを含む) が含まれます。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
SymbolicLink パラメーターに指定されたバッファーは、null ターミネータを含むシンボリック リンク名を格納するのに十分な大きさではありません。 |
|
センサー デバイスが初期化されていません。 |
解説
MFSensorDeviceType 列挙体のメンバーによって定義され、GetDeviceType を呼び出すことによって取得できるデバイスの種類に応じて、生成されるシンボリック名は有効なデバイス シンボリック名またはプロバイダー URL になります。 呼び出し元は名前の解析を試みず、不透明なデータとして扱う必要があります。
要件
サポートされている最小のクライアント | Windows 10、バージョン 1607 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | mfidl.h |
Library | Mfplat.lib;Mfplat.dll |