IWDFDevice2::RegisterRemoteInterfaceNotification-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]
Die RegisterRemoteInterfaceNotification-Methode registriert einen Treiber, um eine Benachrichtigung zu erhalten, wenn eine angegebene Geräteschnittstelle verfügbar wird.
Syntax
HRESULT RegisterRemoteInterfaceNotification(
[in] LPCGUID pDeviceInterfaceGuid,
[in] BOOL IncludeExistingInterfaces
);
Parameter
[in] pDeviceInterfaceGuid
Ein Zeiger auf eine GUID, die eine Geräteschnittstelle identifiziert.
[in] IncludeExistingInterfaces
Ein boolescher Wert. Wenn der Treiber diesen Wert auf TRUE festlegt, benachrichtigt das Framework den Treiber, wenn die angegebene Geräteschnittstelle verfügbar wird, nachdem der Treiber RegisterRemoteInterfaceNotification aufgerufen hat, und benachrichtigt den Treiber auch, ob die Geräteschnittstelle vor dem Treiber namens RegisterRemoteInterfaceNotification verfügbar war.
Wenn der Treiber diesen Wert auf FALSE festlegt, benachrichtigt das Framework den Treiber nur, wenn die Geräteschnittstelle verfügbar wird, nachdem der Treiber RegisterRemoteInterfaceNotification aufgerufen hat.
Rückgabewert
RegisterRemoteInterfaceNotification gibt zurück, S_OK des Vorgangs erfolgreich ist. Andernfalls gibt diese Methode einen weiteren Wert zurück, den Winerror.h enthält.
Hinweise
Ihr Treiber kann RegisterRemoteInterfaceNotification nur aufrufen, wenn die Rückrufschnittstelle, die der Treiber zuvor an IWDFDriver::CreateDevice übergeben hat , die IPnpCallbackRemoteInterfaceNotification-Schnittstelle unterstützt.
Weitere Informationen finden Sie unter Verwenden von Geräteschnittstellen in UMDF-basierten Treibern.
Beispiele
Das folgende Codebeispiel zeigt, wie eine IDriverEntry::OnDeviceAdd-Rückruffunktion sich für die Benachrichtigung über das Eintreffen einer Geräteschnittstelle registrieren kann.
HRESULT
CMyDriver::OnDeviceAdd(
__in IWDFDriver *FxDriver,
__in IWDFDeviceInitialize *FxDeviceInit
)
{
CComPtr<IWDFDevice> fxDevice;
HRESULT hr;
//
// Create a device object and obtain the IWDFDevice interface.
//
hr = FxDriver->CreateDevice(FxDeviceInit,
MyDeviceIUnknown,
&fxDevice);
if (FAILED(hr)) goto Error;
//
// Obtain the IWDFDevice2 interface from IWDFDevice.
//
CComPtr<IWDFDevice2> fxDevice2;
if (FAILED(hr)) goto Error;
hr = fxDevice->QueryInterface(IID_PPV_ARGS(&fxDevice2));
if (S_OK != hr) goto Error;
//
// Register for notification when a device interface
// arrives.
//
hr = fxDevice2->RegisterRemoteInterfaceNotification(&GUID_DEVINTERFACE_TOASTER,
true);
...
}
Anforderungen
Anforderung | Wert |
---|---|
Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
Zielplattform | Desktop |
UMDF-Mindestversion | 1.9 |
Kopfzeile | wudfddi.h (include Wudfddi.h) |
DLL | WUDFx.dll |
Weitere Informationen
IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival