SwDeviceInterfaceRegister 関数 (swdevice.h)

ソフトウェア デバイスのデバイス インターフェイスを登録し、必要に応じてそのインターフェイスのプロパティを設定します。

構文

HRESULT SwDeviceInterfaceRegister(
  [in]            HSWDEVICE         hSwDevice,
  [in]            const GUID        *pInterfaceClassGuid,
  [in, optional]  PCWSTR            pszReferenceString,
  [in]            ULONG             cPropertyCount,
  [in, optional]  const DEVPROPERTY *pProperties,
  [in]            BOOL              fEnabled,
  [out, optional] PWSTR             *ppszDeviceInterfaceId
);

パラメーター

[in] hSwDevice

デバイス インターフェイスを登録するソフトウェア デバイスへの HSWDEVICE ハンドル。

[in] pInterfaceClassGuid

このインターフェイスが実装するコントラクトに名前を付けるインターフェイス クラス GUID へのポインター。

[in, optional] pszReferenceString

このデバイスの同じクラスの複数のインターフェイスを区別する省略可能な参照文字列。 このポインターには NULL を指定できます。

[in] cPropertyCount

pProperties 配列内の DEVPROPERTY 構造体の数。

[in, optional] pProperties

インターフェイスで設定するプロパティの DEVPROPERTY 構造体の省略可能な配列。 このポインターには NULL を指定できます。

インターフェイスが作成された後、インターフェイスが作成されたことを示す通知が送信される前に、これらのプロパティをインターフェイスに設定します。 詳細については、「解説」を参照してください。 このポインターには NULL を指定できます。

[in] fEnabled

インターフェイスを有効または無効にするかどうかを示すブール値。 有効にする場合は TRUE 。 無効にする場合は FALSE 。

[out, optional] ppszDeviceInterfaceId

インターフェイスのデバイス インターフェイス ID へのポインターを受け取る変数へのポインター。 呼び出し元は 、SwMemFree を使用してこの値を解放する必要があります。 クライアント アプリが名前を取得する必要がない場合は、この値を NULL にすることができます。

戻り値

swDeviceInterfaceRegister がインターフェイスを正常に登録した場合、S_OKが返されます。それ以外の場合は、適切なエラー値。

解説

SwDeviceInterfaceRegister は、オペレーティング システムがクライアント アプリの SW_DEVICE_CREATE_CALLBACK コールバック関数を呼び出して、デバイスの列挙が完了したことをクライアント アプリに通知した後にのみ呼び出すことができます。

SWDeviceCapabilitiesDriverRequired 機能を指定するソフトウェア デバイスの SwDeviceInterfaceRegister を呼び出すことはできません。

要件

サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	ユニバーサル
Header	swdevice.h
Library	Swdevice.lib;Windows 10の OneCoreUAP.lib
[DLL]	Cfgmgr32.dll

関連項目

SwMemFree