IWDFDevice2::RegisterRemoteInterfaceNotification-Methode (wudfddi.h)

  • Artikel

[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

IWDFDevice2