次の方法で共有


KsOpenDefaultDevice 関数 (ksproxy.h)

KsOpenDefaultDevice 関数は、指定されたプラグ アンド プレイ (PnP) カテゴリに一覧表示されている最初のデバイスへのハンドルを開きます。

構文

KSDDKAPI HRESULT KsOpenDefaultDevice(
  [in]  REFGUID     Category,
  [in]  ACCESS_MASK Access,
  [out] PHANDLE     DeviceHandle
);

パラメーター

[in] Category

列挙する PnP カテゴリの識別子。

[in] Access

既定のデバイスにアクセスする方法を指定するACCESS_MASKビットマスク。

[out] DeviceHandle

開かれている既定のデバイスへのハンドルを受け取る変数へのポインター。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラー コードを返します。

備考

KsOpenDefaultDevice 関数は、SetupDiGetClassDevs 関数の呼び出しで Category へのポインターを渡して、PnP デバイスの一覧へのハンドルを取得します。 ACCESS_MASK ビットマスクと SetupDiGetClassDevs の詳細については、Microsoft Windows SDK のドキュメントを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー ksproxy.h (Ksproxy.h を含む)
ライブラリ Ksproxy.lib