IMDSPStorage2::CreateStorage2 메서드(mswmdm.h)
CreateStorage2 메서드는 지정된 이름의 새 스토리지를 만들고 새로 만든 스토리지의 IMDSPStorage 인터페이스에 대한 포인터를 반환합니다.
구문
HRESULT CreateStorage2(
[in] DWORD dwAttributes,
[in] DWORD dwAttributesEx,
[in] _WAVEFORMATEX *pAudioFormat,
[in] _VIDEOINFOHEADER *pVideoFormat,
[in] LPWSTR pwszName,
[in] ULONGLONG qwFileSize,
[out] IMDSPStorage **ppNewStorage
);
매개 변수
[in] dwAttributes
IMDSPStorage::CreateStorage 메서드에 설명된 대로 특성을 포함하는 DWORD입니다.
[in] dwAttributesEx
확장된 특성을 포함하는 DWORD입니다. 현재 정의된 확장 특성이 없습니다.
[in] pAudioFormat
개체에 대한 오디오 형식 정보를 포함하는 _WAVEFORMATEX 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 파일이 오디오가 아닌 경우 무시됩니다.
[in] pVideoFormat
개체에 대한 비디오 형식 정보를 포함하는 _VIDEOINFOHEADER 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 파일이 비디오가 아닌 경우 무시됩니다.
[in] pwszName
새 스토리지의 이름을 포함하는 와이드 문자 null로 끝나는 문자열에 대한 포인터입니다.
[in] qwFileSize
만들 파일의 크기를 포함하는 QWORD입니다. 생성 시 출력 파일의 총 크기를 알 수 없는 경우 이 값은 0으로 설정됩니다.
[out] ppNewStorage
새로 만든 스토리지에 대한 IMDSPStorage 인터페이스를 수신하는 IMDSPStorage 포인터에 대한 포인터입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. Windows Media 장치 관리자 모든 인터페이스 메서드는 다음 오류 코드 클래스를 반환할 수 있습니다.
- 표준 COM 오류 코드
- HRESULT 값으로 변환된 Windows 오류 코드
- Windows Media 장치 관리자 오류 코드
설명
WMDM_FILE_ATTR_FOLDER 및 WMDM_FILE_ATTR_FILE 특성이 모두 설정되면 폴더 특성이 파일 특성을 재정의하고 새 스토리지가 폴더로 만들어집니다.
WMDM_STORAGECONTROL_INSERTBEFORE, WMDM_STORAGECONTROL_INSERTAFTER 및 WMDM_STORAGECONTROL_INSERTINTO 중 하나만 클라이언트에서 지정할 수 있습니다.
현재 스토리지가 폴더인 경우 새 스토리지를 동일한 수준에서 만들거나 현재 스토리지에 삽입할 수 있습니다. 이는 dwAttributes 매개 변수의 값에 의해 제어됩니다. WMDM_STORAGECONTROL_INSERTBEFORE 또는 WMDM_STORAGECONTROL_INSERTAFTER 지정하는 경우 새 스토리지는 현재 스토리지와 동일한 수준에서 만들어집니다. WMDM_STORAGECONTROL_INSERTINTO 지정하면 새 스토리지가 현재 스토리지에 삽입됩니다.
WMDM_STORAGECONTROL_INSERTBEFORE 및 WMDM_STORAGECONTROL_INSERAFTER 파일 시스템의 콘텐츠 순서를 의미합니다. 파일 시스템에서 정렬(예: FAT32)을 지원하지 않는 경우 두 플래그 모두 현재 스토리지와 동일한 수준에서 새 스토리지를 삽입하는 것과 동일한 효과를 줍니다. 현재 스토리지가 스토리지 매체의 루트를 나타내고 이러한 두 플래그 중 하나가 지정된 경우 작업이 실패합니다.
WMDM_STORAGECONTROL_INSERTINTO 현재 스토리지가 폴더인 경우에만 유효합니다. 현재 스토리지가 파일이고 이 플래그를 지정하면 작업이 실패합니다.
이 메서드를 구현해야 합니다. WMDM_E_NOTSUPPORTED 또는 E_NOTIMPL 반환하지 않아야 합니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | mswmdm.h |
라이브러리 | Mssachlp.lib |