다음을 통해 공유

IMbnDeviceService::WriteData 메서드(mbnapi.h)

  • 아티클

중요

Windows 10 버전 1803부터 이 섹션에 설명된 Win32 API는 Windows.Networking.Connectivity 네임스페이스의 Windows 런타임 API로 대체됩니다.

디바이스 서비스 데이터 세션에 데이터를 씁니다.

구문

HRESULT WriteData(
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

매개 변수

[in] deviceServiceData

쓸 디바이스에 전달되는 바이트 배열입니다.

[out] requestID

이 요청을 식별하기 위해 모바일 광대역 서비스에서 할당한 고유한 요청 ID입니다.

반환 값

메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
S_OK
 메서드가 완료되었습니다.
E_ACCESSDENIED
 이 디바이스 서비스 명령은 프로세스 권한을 호출할 수 없습니다.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
 deviceServiceData의 길이가 지원되는 MaxDataSize보다 큽니다.
HRESULT_FROM_WIN32(ERROR_OPEN_FAILED)
 디바이스 서비스 세션이 열려 있지 않습니다.
기타
 이 메서드를 실행할 때 오류가 발생했습니다.

설명

WriteData 는 대량 데이터를 디바이스의 공급업체별 디바이스 서비스에 전달합니다. 모바일 광대역 서비스는 이 요청을 디바이스에 전달합니다. deviceServiceData 는 바이트 바이트를 요청에 전달된 데이터 버퍼에 복사합니다. 이 데이터 버퍼는 MaxDataSize 바이트보다 작아야 합니다.

애플리케이션이 WriteData를 호출하려면 먼저 데이터 세션을 열어야 합니다. 운영 체제는 WriteData의 대기 시간 또는 성능을 보장하지 않습니다.

이는 비동기 작업이며 WriteData 는 즉시 반환됩니다. 작업이 완료되면 모바일 광대역 서비스는 IMbnDeviceServicesEvents 인터페이스의 OnWriteDataComplete 메서드를 호출합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 mbnapi.h

참고 항목

IMbnDeviceService