IWDFRemoteInterfaceInitialize::GetInterfaceGuid method (wudfddi.h)

Article
10/21/2021

[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

[out] pDeviceInterfaceGuid

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

Requirement	Value
End of support	Unavailable in UMDF 2.0 and later.
Target Platform	Desktop
Minimum UMDF version	1.9
Header	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Share via