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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
ERROR_INSUFFICIENT_BUFFER
 SymbolicLink パラメーターに指定されたバッファーは、null ターミネータを含むシンボリック リンク名を格納するのに十分な大きさではありません。
MF_E_NOT_INITIALIZED
 センサー デバイスが初期化されていません。

解説

MFSensorDeviceType 列挙体のメンバーによって定義され、GetDeviceType を呼び出すことによって取得できるデバイスの種類に応じて、生成されるシンボリック名は有効なデバイス シンボリック名またはプロバイダー URL になります。 呼び出し元は名前の解析を試みず、不透明なデータとして扱う必要があります。

要件

   
サポートされている最小のクライアント Windows 10、バージョン 1607 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mfidl.h
Library Mfplat.lib;Mfplat.dll

関連項目

IMFSensorDevice