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 함수를 호출하는 호출 스레드 외부에서 이루어집니다. |
발언
사용자 모드 드라이버는 필요에 따라 이 함수를 호출하여 데이터 속도 알림 콜백 함수에 대한 자동 호출을 1초에 한 번 등록할 수 있습니다.
알림에서 등록을 취소하려면 드라이버는 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(Netdispumdddi.h 포함) |