IWDFRemoteInterfaceInitialize::GetInterfaceGuid method

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The GetInterfaceGuid method retrieves the GUID that identifies a device interface.

Syntax


void GetInterfaceGuid(
  [out] LPGUID pDeviceInterfaceGuid
);

Parameters

pDeviceInterfaceGuid [out]

A pointer to a driver-allocated GUID structure that receives the device interface GUID.

Return value

None.

Remarks

For more information about the GetInterfaceGuid method, see Using Device Interfaces in UMDF-based Drivers.

Examples

The following code example shows how a driver's IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival callback function can obtain the GUID that identifies the device interface that has arrived.


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

Requirements

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.9

Header

Wudfddi.h (include Wudfddi.h)

DLL

WUDFx.dll

See also

IWDFRemoteInterfaceInitialize
IWDFRemoteInterfaceInitialize::RetrieveSymbolicLink

 

 

Send comments about this topic to Microsoft

Show: