IMDSPDevice::GetStatus 메서드(mswmdm.h)

아티클
03/05/2024

GetStatus 메서드는 디바이스에서 제공할 수 있는 모든 디바이스 상태 정보를 검색합니다.

구문

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

매개 변수

[out] pdwStatus

현재 디바이스 상태 수신하는 DWORD에 대한 포인터입니다. 이러한 상태 값은 다음 표에 정의되어 있습니다.

상태	Description
WMDM_STATUS_READY	Windows Media 장치 관리자 및 하위 구성 요소는 준비 상태입니다.
WMDM_STATUS_BUSY	작업이 진행 중입니다. 다른 상태 값을 확인하여 작업이 무엇인지 확인합니다.
WMDM_STATUS_DEVICE_NOTPRESENT	디바이스가 컴퓨터에 연결되어 있지 않습니다.
WMDM_STATUS_STORAGE_NOTPRESENT	매체가 없습니다. 둘 이상의 매체를 지원하는 디바이스의 경우 이 값은 IWMDMStorageGlobals 인터페이스에서만 보고됩니다.
WMDM_STATUS_STORAGE_INITIALIZING	디바이스가 현재 디바이스의 미디어 서식을 지정하는 데 사용 중입니다.
WMDM_STATUS_STORAGE_BROKEN	매체가 작동하지 않습니다. 둘 이상의 매체를 지원하는 디바이스의 경우 이 값은 IWMDMStorageGlobals 인터페이스에서만 보고됩니다.
WMDM_STATUS_STORAGE_NOTSUPPORTED	매체는 디바이스에서 지원되지 않습니다. 둘 이상의 매체를 지원하는 디바이스의 경우 이 값은 IWMDMStorageGlobals 인터페이스에서만 반환됩니다.
WMDM_STATUS_STORAGE_UNFORMATTED	매체의 형식이 지정되지 않았습니다. 둘 이상의 매체를 지원하는 디바이스의 경우 이 값은 IWMDMStorageGlobals 인터페이스에서만 반환됩니다.
WMDM_STATUS_STORAGECONTROL_INSERTING	IWMDMStorageControl::Insert 메서드가 현재 실행 중입니다.
WMDM_STATUS_STORAGECONTROL_DELETING	IWMDMStorageControl::D elete 메서드가 현재 실행 중입니다.
WMDM_STATUS_STORAGECONTROL_MOVING	IWMDMStorageControl::Move 메서드가 현재 실행 중입니다.
WMDM_STATUS_STORAGECONTROL_READING	IWMDMStorageControl::Read 메서드가 현재 실행 중입니다.

반환 값

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

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

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

설명

이 호출에서 하나 이상의 상태 값을 반환할 수 있습니다. 미디어 디바이스의 모든 인터페이스에 대한 모든 상태 값은 이 호출을 통해 보고됩니다. 예를 들어 미디어 디바이스에 파일을 쓰는 등의 스토리지 작업이 진행 중인 경우 이 메서드에 대한 호출은 해당 작업의 사용 중인 상태 보고합니다. 진행 중인 작업의 경우 WMDM_STATUS_BUSY 상태 값이 항상 존재합니다.

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