PFN_REGISTER_DATARATE_NOTIFICATIONS 콜백 함수(netdispumdddi.h)

  • 아티클

사용자 모드 드라이버가 운영 체제에 등록하여 QoS(네트워크 서비스 품질) 알림 및 Miracast 연결의 현재 네트워크 대역폭을 수신하도록 호출합니다. 이 함수의 데이터 형식은 PFN_REGISTER_DATARATE_NOTIFICATIONS.

구문

PFN_REGISTER_DATARATE_NOTIFICATIONS PfnRegisterDatarateNotifications;

NTSTATUS PfnRegisterDatarateNotifications(
  [in]           HANDLE hMiracastDeviceHandle,
  [in, optional] PVOID pNotificationContext,
  [in, optional] PFN_DATARATE_NOTIFICATION pfnDataRateNotify
)
{...}

매개 변수

[in] hMiracastDeviceHandle

Miracast 디바이스를 나타내는 핸들입니다. Miracast 사용자 모드 드라이버는 이전에 CreateMiracastContext 함수 호출에서 hMiracastDeviceHandle 매개 변수로 이 핸들을 얻었습니다.

[in, optional] pNotificationContext

Miracast 데이터 속도가 변경될 때 pfnDataRateNotify 함수에 전달될 컨텍스트입니다.

[in, optional] pfnDataRateNotify

Miracast 네트워크 링크의 비트 속도가 변경될 때 호출되는 드라이버 루틴에 대한 포인터입니다. 자세한 내용은 비고를 참조하세요.

드라이버는 알림을 등록 취소하는 NULL 값을 제공할 수 있습니다.

반환 값

운영 체제가 알림을 위해 드라이버를 성공적으로 등록하거나 등록 취소하면 STATUS_SUCCESS 반환됩니다.

그렇지 않으면 다음 오류 코드를 반환할 수 있습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER 하나 이상의 매개 변수가 잘못되었습니다.
STATUS_NOT_SUPPORTED 운영 체제는 QoS(서비스 품질) 알림을 지원할 수 없거나, StartMiracastSession 또는 StopMiracastSession 이라는 운영 체제가 함수를 호출하는 호출 스레드 외부에서 함수를 호출합니다.

설명

사용자 모드 드라이버는 필요에 따라 이 함수를 호출하여 데이터 속도 알림 콜백 함수에 대한 자동 호출을 등록할 수 있습니다.

알림에서 등록을 취소하려면 드라이버는 pfnDataRateNotify 매개 변수 및 StartMiracastSession 함수를 호출할 때 pWfdConnectionStats 매개 변수가 가리키는 MIRACAST_WFD_CONNECTION_STATS 구조체의 CurrentBitRate 멤버에 대해 NULL 값을 제공해야 합니다. 운영 체제가 pfnDataRateNotify 및 CurrentBitRate 모두에 대해 NULL을 받으면 더 이상 알림을 제공하지 않습니다.

또한 운영 체제가 더 이상 QoS 데이터를 제공할 수 없는 경우 pfnDataRateNotify 함수가 호출될 때 pDataRateStats 매개 변수를 NULL로 설정합니다.

드라이버가 이미 등록되어 있는 동안 등록을 시도하거나 이미 등록을 취소한 경우 등록을 취소하려고 하면 함수가 실패합니다. StartMiracastSession 또는 StopMiracastSession이라는 운영 체제가 작동하는 호출 스레드 외부에서 호출이 이루어지면 함수가 실패합니다.

요구 사항

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

추가 정보

CreateMiracastContext

MIRACAST_WFD_CONNECTION_STATS

StartMiracastSession

pfnDataRateNotify