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

インターフェイス 設定するプロパティの 構造体の省略可能な配列です。 このポインターは 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
ターゲット プラットフォーム の	万国
ヘッダー	swdevice.h
ライブラリ	Swdevice.lib;Windows 10 の OneCoreUAP.lib
DLL	Cfgmgr32.dll

関連項目

SwMemFree