Partilhar via


Método IWDFRemoteInterfaceInitialize::GetInterfaceGuid (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método GetInterfaceGuid recupera o GUID que identifica uma interface de dispositivo.

Sintaxe

void GetInterfaceGuid(
  [out] LPGUID pDeviceInterfaceGuid
);

Parâmetros

[out] pDeviceInterfaceGuid

Um ponteiro para uma estrutura GUID alocada por driver que recebe o GUID da interface do dispositivo.

Retornar valor

Nenhum

Comentários

Para obter mais informações sobre o método GetInterfaceGuid , consulte Usando interfaces de dispositivo em drivers baseados em UMDF.

Exemplos

O exemplo de código a seguir mostra como a função de retorno de chamada IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival de um driver pode obter o GUID que identifica a interface do dispositivo que chegou.

void 
STDMETHODCALLTYPE
CMyDevice::OnRemoteInterfaceArrival(
    __in IWDFRemoteInterfaceInitialize  *FxRemoteInterfaceInit
    )
{
    GUID DeviceInterfaceGUID;
    FxRemoteInterfaceInit->GetInterfaceGuid(&DeviceInterfaceGUID);
...
}

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1,9
Cabeçalho wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Confira também

IWDFRemoteInterfaceInitialize

IWDFRemoteInterfaceInitialize::RetrieveSymbolicLink