IWDFDevice2::RegisterRemoteInterfaceNotification 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

RegisterRemoteInterfaceNotification 메서드는 지정된 디바이스 인터페이스를 사용할 수 있게 되면 알림을 받을 드라이버를 등록합니다.

구문

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

매개 변수

[in] pDeviceInterfaceGuid

디바이스 인터페이스를 식별하는 GUID에 대한 포인터입니다.

[in] IncludeExistingInterfaces

부울 값입니다. 드라이버가 이 값을 TRUE로 설정하면 드라이버가 RegisterRemoteInterfaceNotification을 호출한 후 지정된 디바이스 인터페이스를 사용할 수 있게 되면 드라이버에 알리고 RegisterRemoteInterfaceNotification이라는 드라이버 전에 디바이스 인터페이스를 사용할 수 있는지 드라이버에 알립니다.

드라이버가 이 값을 FALSE로 설정하면 드라이버가 RegisterRemoteInterfaceNotification을 호출한 후에 디바이스 인터페이스를 사용할 수 있게 되는 경우에만 프레임워크가 드라이버에 알릴 수 있습니다.

반환 값

RegisterRemoteInterfaceNotification 은 작업의 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 포함된 다른 값을 반환합니다.

설명

드라이버는 드라이버가 이전에 IWDFDriver::CreateDevice에 전달한 콜백 인터페이스가 IPnpCallbackRemoteInterfaceNotification 인터페이스를 지원하는 경우에만 RegisterRemoteInterfaceNotification을 호출할 수 있습니다.

자세한 내용은 UMDF 기반 드라이버에서 디바이스 인터페이스 사용을 참조하세요.

예제

다음 코드 예제에서는 IDriverEntry::OnDeviceAdd 콜백 함수가 디바이스 인터페이스 도착 알림을 등록할 수 있는 방법을 보여줍니다.

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

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.9
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IWDFDevice2