다음을 통해 공유


IMDServiceProvider2::CreateDevice 메서드(mswmdm.h)

CreateDevice 메서드는 Windows Media 장치 관리자 PnP 하위 시스템으로부터 가져온 정식 디바이스에 해당하는 IMDSPDevice 개체를 가져오기 위해 호출됩니다. PnP 및 Windows Explorer 지원을 위해 이 메서드를 구현해야 하지만 그렇지 않으면 선택 사항입니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.

구문

HRESULT CreateDevice(
  [in]  LPCWSTR     pwszDevicePath,
  [out] DWORD       *pdwCount,
  [out] IMDSPDevice ***pppDeviceArray
);

매개 변수

[in] pwszDevicePath

Windows Media 장치 관리자 검색된 디바이스의 디바이스 경로를 포함하는 와이드 문자 null로 끝나는 문자열에 대한 포인터입니다. 이 이름은 PnP 하위 시스템으로부터 가져오며 정식 이름과 "$ # "입니다. 여기서 # 는 자동 증가된 숫자입니다. 이 이름은 기본 커널 디바이스 개체에 대한 액세스 권한을 얻기 위해 CreateFile 과 같은 함수에 직접 전달될 수 있습니다. 서비스 공급자는 이 디바이스에 대한 래퍼 IMDSPDevice 개체를 만들어야 합니다.

[out] pdwCount

만들어진 IMDSPDevice 개체의 수를 포함하는 DWORD에 대한 포인터입니다.

[out] pppDeviceArray

디바이스를 나타내는 IMDSPDevice 인터페이스의 배열입니다. 일반적으로 배열 요소는 하나만 있지만 서비스 공급자는 각 최상위 스토리지에 대해 IMDSPDevice 개체를 만드는 경우 디바이스 경로 이름에 해당하는 둘 이상의 IMDSPDevice 개체를 만들 수 있습니다. 이는 향후 변경될 수 있으며 개수는 1로 제한될 수 있습니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 Windows Media 장치 관리자 오류 코드가 반환됩니다.

설명

Windows Media 장치 관리자 애플리케이션이 시작되거나 플러그 앤 플레이 규격 디바이스가 컴퓨터에 연결할 때 이 메서드를 호출합니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 mswmdm.h
라이브러리 Mssachlp.lib

추가 정보

디바이스 열거

IMDServiceProvider2 인터페이스