IMDSPStorage::GetAttributes 메서드(mswmdm.h)

아티클
03/05/2024

GetAttributes 메서드는 이 스토리지 개체의 특성을 검색합니다.

구문

HRESULT GetAttributes(
  [out] DWORD         *pdwAttributes,
  [out] _WAVEFORMATEX *pFormat
);

매개 변수

[out] pdwAttributes

IWMDMStorage::GetAttributes 메서드에 정의된 특성을 포함하는 DWORD에 대한 포인터입니다.

[out] pFormat

개체에 대한 특성 정보로 채워진 _WAVEFORMATEX 구조체에 대한 포인터입니다.

반환 값

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

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

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

설명

특성 평가는 미디어 디바이스의 콘텐츠를 노출할 때 중요한 단계입니다. 디바이스는 스토리지 미디어에서 데이터의 계층적 스토리지를 지원하지 않을 수 있습니다. GetAttributes 메서드를 사용하면 애플리케이션이 개체 특성을 통해 해당 구조를 검색하여 파일 시스템의 지원 및 형식을 유추할 수 있습니다.

예를 들어 최상위 IMDSPStorage 인터페이스의 특성은 스토리지 매체를 나타내고 IMDSPEnumStorage 는 매체의 내용을 노출합니다. .mp3 파일의 경우 특성은 특성과 파일 이름을 추가로 검사하여 형식을 확인할 수 있는 파일을 나타냅니다. 계층적 매체에서 특성은 IMDSPStorage::EnumStorage에서 콘텐츠를 노출할 수 있는 디렉터리를 나타낼 수 있습니다.

_WAVEFORMATEX 매개 변수는 선택 사항입니다. 오디오 파일에 유효한 _WAVEFORMATEX 포인터를 전달하면 GetAttributes 는 설명 정보를 구조체로 다시 전달합니다. 그러나 파일이 오디오가 아닌 경우 _WAVEFORMATEX 매개 변수는 무시됩니다.

이 메서드를 구현해야 합니다. WMDM_E_NOTSUPPORTED 또는 E_NOTIMPL 반환해서는 안 됩니다. 자세한 내용은 필수 및 선택적 인터페이스를 참조하세요.