funzione CM_Get_Device_Interface_AliasW (cfgmgr32.h)

  • Articolo

La funzione CM_Get_Device_Interface_Alias restituisce l'alias dell'istanza dell'interfaccia del dispositivo specificata, se l'alias esiste.

Sintassi

CMAPI CONFIGRET CM_Get_Device_Interface_AliasW(
  [in]      LPCWSTR pszDeviceInterface,
  [in]      LPGUID  AliasInterfaceGuid,
  [out]     LPWSTR  pszAliasDeviceInterface,
  [in, out] PULONG  pulLength,
  [in]      ULONG   ulFlags
);

Parametri

[in] pszDeviceInterface

Puntatore al nome dell'istanza dell'interfaccia del dispositivo per cui recuperare un alias. Il chiamante ha in genere ricevuto questa stringa da una chiamata a CM_Get_Device_Interface_List o in una struttura di notifica PnP.

[in] AliasInterfaceGuid

Puntatore a un GUID che specifica la classe di interfaccia dell'alias da recuperare.

[out] pszAliasDeviceInterface

Specifica un puntatore a un buffer, che al termine della restituzione punta a una stringa contenente il nome dell'alias. Il chiamante deve liberare questa stringa quando non è più necessaria.

È necessario un buffer. In caso contrario, la chiamata avrà esito negativo.

[in, out] pulLength

Fornisce il numero di caratteri in pszAliasDeviceInterface e riceve il numero di caratteri necessari per contenere l'interfaccia del dispositivo alias.

In input, questo parametro deve essere maggiore di 0.

[in] ulFlags

Riservato. Non usare.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Codice restituito Descrizione
CR_NO_SUCH_DEVICE_INTERFACE
 Probabilmente indica che non è presente alcun alias della classe di interfaccia specificata.
CR_OUT_OF_MEMORY
 Memoria insufficiente per completare l'operazione.
CR_BUFFER_SMALL
 Il buffer passato è troppo piccolo.

Commenti

Le interfacce del dispositivo sono considerate alias se vengono esposte dallo stesso dispositivo sottostante e hanno stringhe di riferimento di interfaccia identiche, ma sono di classi di interfaccia diverse.

Il parametro pszDeviceInterface specifica un'istanza dell'interfaccia del dispositivo per un determinato dispositivo, appartenente a una determinata classe di interfaccia, con una determinata stringa di riferimento. CM_Get_Device_Interface_Alias restituisce un'altra istanza dell'interfaccia del dispositivo per lo stesso dispositivo e la stessa stringa di riferimento, ma di una classe di interfaccia diversa, se esistente.

Ad esempio, il driver di funzione per un volume a tolleranza di errore può registrare e impostare due interfacce di dispositivo, una della classe di interfaccia del volume a tolleranza di errore e una della classe di interfaccia del volume. Un altro driver potrebbe chiamare CM_Get_Device_Interface_Alias con il collegamento simbolico per una delle interfacce e chiedere se l'altra interfaccia esiste specificando la relativa classe di interfaccia.

Due interfacce di dispositivo con stringhe di riferimento NULL sono alias se vengono esposti dallo stesso dispositivo sottostante e hanno GUID di classe di interfaccia diversi.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib