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

要件