IWMDMStorageControl::Read 메서드(mswmdm.h)

아티클
02/29/2024

Read 메서드는 현재 스토리지를 컴퓨터에 복사합니다.

구문

HRESULT Read(
  [in] UINT           fuMode,
  [in] LPWSTR         pwszFile,
  [in] IWMDMProgress  *pProgress,
  [in] IWMDMOperation *pOperation
);

매개 변수

[in] fuMode

읽기 작업에 사용되는 처리 모드 입니다 . 다음 표에서는 fuMode 매개 변수에 지정할 수 있는 처리 모드를 나열합니다. 처음 두 모드 중 하나와 마지막 3개(WMDM_CONTENT) 모드 중 정확히 하나를 지정해야 합니다. WMDM_MODE_BLOCK 및 WMDM_MODE_THREAD 모두 지정되면 블록 모드가 사용됩니다.

Mode	Description
WMDM_MODE_BLOCK	작업은 블록 모드 처리를 사용하여 수행됩니다. 작업이 완료될 때까지 호출이 반환되지 않습니다.
WMDM_MODE_THREAD	작업은 스레드 모드 처리를 사용하여 수행됩니다. 호출은 즉시 반환되고 작업은 백그라운드 스레드에서 수행됩니다.
WMDM_CONTENT_FILE	호출자는 Windows 미디어가 휴대용 디바이스에서 하드 디스크의 파일로 파일을 읽을 장치 관리자 요청합니다. 호출자는 pwszFileName 매개 변수에서 파일의 전체 경로와 이름을 나타내야 합니다.
WMDM_CONTENT_FOLDER	호출자는 Windows Media가 폴더의 지정된 폴더, 내용 및 휴대용 디바이스에서 하드 디스크로 하위 폴더의 내용을 읽을 장치 관리자 요청합니다. 호출자는 pwszFileName 매개 변수의 하드 디스크에 있는 대상 디렉터리의 전체 경로를 나타내야 합니다. 이는 현재 Microsoft에서 제공하는 서비스 공급자에서 지원되지 않습니다.
WMDM_CONTENT_OPERATIONINTERFACE	애플리케이션 구현 IWMDMOperation 인터페이스는 파일 이름을 전달하는 대신 데이터를 읽는 데 사용됩니다.

[in] pwszFile

휴대용 디바이스의 콘텐츠가 복사되는 컴퓨터의 정규화된 파일 이름에 대한 포인터입니다. 파일 이름에는 확장명을 포함해야 합니다. 디바이스의 현재 스토리지 확장은 사용되지 않습니다. fuMode에서 WMDM_CONTENT_OPERATIONINTERFACE 지정하면 이 매개 변수는 무시됩니다.

[in] pProgress

진행 중인 작업의 진행 상황을 추적하기 위해 애플리케이션에서 구현한 IWMDMProgress 인터페이스에 대한 선택적 포인터입니다.

[in] pOperation

미디어 디바이스에서 콘텐츠 전송을 향상시키는 데 사용되는 선택적 메서드 집합인 IWMDMOperation 인터페이스에 대한 선택적 포인터입니다. fuMode에서 WMDM_CONTENT_FILE 또는 WMDM_CONTENT_FOLDER 지정한 경우 이 매개 변수는 NULL이어야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스 중 어느 것을 반환할 수 있습니다.

표준 COM 오류 코드
HRESULT 값으로 변환된 Windows 오류 코드
Windows Media 장치 관리자 오류 코드

가능한 오류 코드의 광범위한 목록은 오류 코드를 참조하세요.

설명

이 메서드는 pwszFilename으로 지정된 기존 파일을 자동으로 덮어씁니다. 있더라도 성공할 수 있습니다.

WMDM_MODE_THREAD 플래그를 지정한 경우 IWMDMProgress2::End2 또는 IWMDMProgress3::End3을 호출하여 완료 상태 가져와야 합니다. 이러한 메서드는 작업이 완료되었는지 확인하고 성공 또는 실패 정보가 포함된 HRESULT도 반환합니다.

애플리케이션이 WMDM_MODE_THREAD 사용하고 null이 아닌 pProgress 매개 변수를 전달하는 경우 Windows Media 장치 관리자 이 개체에 진행률 알림을 보내기 때문에 pProgress가 속한 개체가 읽기 작업이 완료될 때까지 제거되지 않도록 해야 합니다. 이 개체는 종료 알림을 받은 후에만 삭제할 수 있습니다. 이렇게 하지 않으면 액세스 위반이 발생합니다.