IWDFDevice::CreateDeviceInterface 메서드(wudfddi.h)

  • 아티클

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

CreateDeviceInterface 메서드는 디바이스 인터페이스 클래스의 instance 만듭니다.

구문

HRESULT CreateDeviceInterface(
  [in]           LPCGUID pDeviceInterfaceGuid,
  [in, optional] PCWSTR  pReferenceString
);

매개 변수

[in] pDeviceInterfaceGuid

디바이스 인터페이스 클래스의 GUID에 대한 포인터입니다.

[in, optional] pReferenceString

디바이스 인터페이스의 instance 이름을 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다. 드라이버가 이름을 제공할 필요가 없는 경우 드라이버는 NULL 을 전달할 수 있습니다. 드라이버에서 이름을 제공해야 하는 경우 드라이버가 전달하는 문자열에는 경로 구분 기호 문자("/" 또는 "\")가 포함되어서는 안 됩니다.

반환 값

CreateDeviceInterface 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

드라이버는 pReferenceString 매개 변수를 사용하여 단일 인터페이스의 여러 인스턴스를 구분할 수 있습니다. 즉, 드라이버가 동일한 디바이스 인터페이스 클래스에 대해 CreateDeviceInterface 를 두 번 호출하는 경우 드라이버는 매번 pReferenceString 에 대해 다른 문자열을 지정할 수 있습니다. 인터페이스의 instance 열리면 프레임워크는 instance 참조 문자열을 드라이버에 전달합니다. 참조 문자열은 인터페이스 instance 이름의 경로 구성 요소에 추가됩니다. 그런 다음 드라이버는 참조 문자열을 사용하여 열려 있는 디바이스 인터페이스 클래스의 instance 확인할 수 있습니다.

CreateDeviceInterface가 성공하면 인터페이스의 초기 상태가 비활성화됩니다. 만들기에 성공하면 프레임워크는 디바이스의 PnP 상태에 따라 인터페이스를 자동으로 사용하도록 설정하고 사용하지 않도록 설정합니다. 또한 드라이버는 IWDFDevice::AssignDeviceInterfaceState를 호출하여 필요에 따라 디바이스 인터페이스를 사용하지 않도록 설정하고 다시 사용하도록 설정할 수 있습니다.

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

예제

다음 코드 예제에서는 디바이스 인터페이스 instance 만드는 방법을 보여줍니다. 이 예제에서 드라이버는 IWDFDevice::AssignDeviceInterfaceState 를 명시적으로 호출하여 인터페이스를 사용하도록 설정합니다.

    //
    // Create the device interface.
    //
    HRESULT hr;
    if (S_OK == hr) {
        hr = m_FxDevice->CreateDeviceInterface(
                         &GUID_DEVINTERFACE_OSRUSBFX2,
                         NULL);
    }
    if (S_OK == hr) {
        hr = m_FxDevice->AssignDeviceInterfaceState(
                        &GUID_DEVINTERFACE_OSRUSBFX2,
                        NULL,
                        TRUE);
    }

요구 사항

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

추가 정보

IWDFDevice

IWDFDevice::AssignDeviceInterfaceState