Metode IWDFDevice2::RegisterRemoteInterfaceNotification (wudfddi.h)

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode RegisterRemoteInterfaceNotification mendaftarkan driver untuk menerima pemberitahuan ketika antarmuka perangkat tertentu tersedia.

Sintaks

HRESULT RegisterRemoteInterfaceNotification(
  [in] LPCGUID pDeviceInterfaceGuid,
  [in] BOOL    IncludeExistingInterfaces
);

Parameter

[in] pDeviceInterfaceGuid

Pointer ke GUID yang mengidentifikasi antarmuka perangkat.

[in] IncludeExistingInterfaces

Nilai Boolean. Jika driver menetapkan nilai ini ke TRUE, kerangka kerja memberi tahu driver jika antarmuka perangkat yang ditentukan tersedia setelah driver memanggil RegisterRemoteInterfaceNotification, dan juga memberi tahu driver jika antarmuka perangkat tersedia sebelum driver yang disebut RegisterRemoteInterfaceNotification.

Jika driver mengatur nilai ini ke FALSE, kerangka kerja akan memberi tahu driver hanya jika antarmuka perangkat tersedia setelah driver memanggil RegisterRemoteInterfaceNotification.

Mengembalikan nilai

RegisterRemoteInterfaceNotification mengembalikan S_OK operasi berhasil. Jika tidak, metode ini mengembalikan nilai lain yang dikandung Winerror.h.

Keterangan

Driver Anda dapat memanggil RegisterRemoteInterfaceNotification hanya jika antarmuka panggilan balik yang sebelumnya diteruskan driver ke IWDFDriver::CreateDevice mendukung antarmuka IPnpCallbackRemoteInterfaceNotification .

Untuk informasi selengkapnya, lihat Menggunakan Antarmuka Perangkat di Driver berbasis UMDF.

Contoh

Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik IDriverEntry::OnDeviceAdd dapat mendaftar untuk pemberitahuan kedatangan antarmuka perangkat.

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);
...
}

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.9
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IWDFDevice2