IMDSPDeviceControl::GetDCStatus 메서드(mswmdm.h)
GetDCStatus 메서드는 디바이스의 컨트롤 상태 검색합니다.
구문
HRESULT GetDCStatus(
[out] DWORD *pdwStatus
);
매개 변수
[out] pdwStatus
디바이스의 컨트롤 상태 포함하는 DWORD에 대한 포인터입니다. 컨트롤 상태 값에는 다음 플래그 중 하나 이상이 포함됩니다.
플래그 | 설명 |
---|---|
WMDM_STATUS_READY | Windows Media 장치 관리자 및 하위 구성 요소는 준비 상태입니다. |
WMDM_STATUS_BUSY | 현재 작업이 수행되고 있습니다. 다른 상태 값을 평가하여 작업이 무엇인지 확인합니다. |
WMDM_STATUS_DEVICECONTROL_PLAYING | 디바이스가 현재 재생되고 있습니다. |
WMDM_STATUS_DEVICECONTROL_RECORDING | 디바이스가 현재 기록되고 있습니다. |
WMDM_STATUS_DEVICECONTROL_PAUSED | 디바이스가 현재 일시 중지되었습니다. |
WMDM_STATUS_DEVICECONTROL_REMOTE | 디바이스의 재생 또는 레코드 작업이 애플리케이션에 의해 원격으로 제어되고 있습니다. |
WMDM_STATUS_DEVICECONTROL_STREAM | play 또는 record 메서드는 미디어 디바이스에서 또는 미디어 디바이스에서 데이터를 스트리밍하는 것입니다. |
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | Description |
---|---|
|
메서드가 성공했습니다. |
|
pdwStatus 매개 변수가 잘못되었거나 NULL 포인터입니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
이 호출은 이 인터페이스의 디바이스 제어 작업과 관련된 상태 값을 반환합니다. 컨트롤 상태 재생, 녹음 등과 같은 디바이스의 제어 관련 활동 상태에 대한 정보를 제공할 수 있습니다. 그러나 디바이스가 데이터를 다운로드하는지 아니면 다른 이유로 액세스하는지 여부와 같이 디바이스의 전역 상태 대한 정보를 제공할 수 없습니다. 디바이스 제어 이외의 이유로 디바이스가 사용 중인 경우 사용 중인 코드가 수신되며, 자세한 내용은 연결된 IMDSPDevice 인터페이스의 GetStatus 메서드를 호출해야 합니다.
WMDM_STATUS_BUSY 상태 값이 반환되고 상태 값에 상태 값 테이블의 다른 값이 포함되지 않은 경우 이 인터페이스의 Play, Record, Pause, Resume 또는 Stop 메서드를 호출하지 않아야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | mswmdm.h |
라이브러리 | Mssachlp.lib |