Funzione SwDeviceInterfaceRegister (swdevice.h)

Registra un'interfaccia del dispositivo per un dispositivo software e, facoltativamente, imposta le proprietà su tale interfaccia.

Sintassi

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
);

Parametri

[in] hSwDevice

Il HSWDEVICE handle per il dispositivo software per cui registrare un'interfaccia del dispositivo.

[in] pInterfaceClassGuid

Puntatore al GUID della classe di interfaccia che denomina il contratto implementato da questa interfaccia.

[in, optional] pszReferenceString

Stringa di riferimento facoltativa che differenzia più interfacce della stessa classe per questo dispositivo. Questo puntatore può essere NULL.

[in] cPropertyCount

Numero di strutture DEVPROPERTY nella matrice pProperties.

[in, optional] pProperties

Matrice facoltativa di strutture DEVPROPERTY per le proprietà da impostare sull'interfaccia. Questo puntatore può essere NULL.

Impostare queste proprietà sull'interfaccia dopo la creazione, ma prima dell'invio di una notifica che informa che l'interfaccia è stata creata. Per altre info, vedi Osservazioni. Questo puntatore può essere NULL.

[in] fEnabled

Valore booleano che indica se abilitare o disabilitare l'interfaccia. TRUE da abilitare; FALSE da disabilitare.

[out, optional] ppszDeviceInterfaceId

Puntatore a una variabile che riceve un puntatore all'ID interfaccia del dispositivo per l'interfaccia. Il chiamante deve liberare questo valore con SwMemFree. Questo valore può essere NULL se l'app client non deve recuperare il nome.

Valore restituito

S_OK viene restituito se SwDeviceInterfaceRegister registrato correttamente l'interfaccia; in caso contrario, un valore di errore appropriato.

Osservazioni

Puoi chiamare swDeviceInterfaceRegister solo dopo che il sistema operativo ha chiamato la funzione di callback SW_DEVICE_CREATE_CALLBACK dell'app client per notificare all'app client che l'enumerazione del dispositivo è stata completata.

Non è possibile chiamare swDeviceInterfaceRegister per i dispositivi software che specificano la funzionalità SWDeviceCapabilitiesDriverRequired.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Universale
intestazione	swdevice.h
libreria	Swdevice.lib; OneCoreUAP.lib in Windows 10
dll	Cfgmgr32.dll

Vedere anche

SwMemFree