PFN_START_MIRACAST_SESSION 콜백 함수(netdispumdddi.h)

아티클
02/26/2024

운영 체제에서 Miracast 연결 세션을 시작하기 위해 호출됩니다.

구문

PFN_START_MIRACAST_SESSION PfnStartMiracastSession;

NTSTATUS PfnStartMiracastSession(
  [in]  PVOID pMiracastContext,
  [in]  SOCKET MiracastRTSPSocket,
  [in]  MIRACAST_WFD_CONNECTION_STATS *pWfdConnectionStats,
  [out] MIRACAST_SESSION_INFO *pSessionInfo
)
{...}

매개 변수

[in] pMiracastContext

디스플레이 어댑터와 연결된 컨텍스트에 대한 포인터입니다.

운영 체제는 Miracast 사용자 모드 드라이버의 CreateMiracastContext 함수를 호출할 때 컨텍스트를 얻었습니다.

[in] MiracastRTSPSocket

RTSP(실시간 스트리밍 프로토콜)의 운영 체제 제공 네트워크 소켓 핸들입니다.

참고 Miracast 사용자 모드 드라이버는 이 소켓을 닫지 않아야 합니다. StopMiracastSession 함수가 호출되면 운영 체제에서 이 소켓을 닫습니다.

[in] pWfdConnectionStats

Wi-Fi 직접 연결 통계를 나타내는 MIRACAST_WFD_CONNECTION_STATS 구조체에 대한 포인터입니다.

[out] pSessionInfo

Miracast 싱크의 기능을 가져온 후 Miracast 사용자 모드 드라이버가 완료해야 하는 MIRACAST_SESSION_INFO 구조체에 대한 포인터입니다.

반환 값

성공하면 이 함수는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 함수는 다음을 포함하여 Ntstatus.h 헤더에 정의된 오류 코드를 반환합니다.

반환 코드	설명
STATUS_DEVICE_INSUFFICIENT_RESOURCES	현재 제안된 인코딩 속도는 1024 x 768픽셀 이상을 지원하는 Miracast 싱크를 유지할 수 없습니다.

설명

이 함수가 호출되면 Miracast 사용자 모드 드라이버는 Miracast 프로토콜을 사용하여 Miracast 싱크와 통신을 시작해야 합니다. 드라이버는 싱크의 기능과 싱크에 연결된 모니터의 특성을 수집해야 합니다. 드라이버는 모니터가 싱크에 연결되어 있는지 여부를 확인하기 위해 싱크와 충분한 협상을 수행해야 합니다. 드라이버가 모니터가 싱크에 연결되어 있다고 판단하는 경우 현재 제안된 비트 전송률이 최소 1024 x 768픽셀의 가장 낮은 싱크 지원 모드를 지원할 만큼 높은지 여부를 결정해야 합니다.

또한 드라이버는 다음과 같은 경우 pSessionInfo가 가리키는 MIRACAST_SESSION_INFO 이러한 멤버의 값을 설정해야 합니다.

스레드 보안

운영 체제는 CreateMiracastContext, DestroyMiracastContext, StartMiracastSession 및 StopMiracastSession 함수 중 하나만 한 번에 호출되도록 보장합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8.1
지원되는 최소 서버	Windows Server 2012 R2
대상 플랫폼	데스크톱
머리글	netdispumdddi.h(Netdispumddddi.h 포함)