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

接收介面裝置介面標識碼指標之變數的指標。 呼叫端必須使用 SwMemFree釋放此值。 如果用戶端應用程式不需要擷取名稱，此值就可以 NULL。

傳回值

如果 SwDeviceInterfaceRegister 成功註冊介面，則會傳回S_OK;否則為適當的錯誤值。

言論

只有在操作系統呼叫用戶端應用程式的 SW_DEVICE_CREATE_CALLBACK 回呼函式，通知用戶端應用程式裝置列舉完成之後，才可以呼叫 SwDeviceInterfaceRegister。

您無法針對指定 SWDeviceCapabilitiesDriverRequired 功能的軟體裝置呼叫 SwDeviceInterfaceRegister。

要求

另請參閱

SwMemFree