функция обратного вызова EVT_URS_SET_ROLE (ursdevice.h)
Расширение класса URS вызывает этот обратный вызов события, когда требуется, чтобы драйвер клиента изменил роль контроллера.
Синтаксис
EVT_URS_SET_ROLE EvtUrsSetRole;
NTSTATUS EvtUrsSetRole(
[in] WDFDEVICE Device,
[in] URS_ROLE Role
)
{...}
Параметры
[in] Device
Дескриптор объекта устройства платформы, полученный драйвером клиента при предыдущем вызове WdfDeviceCreate.
[in] Role
Значение типа URS_ROLE , указывающее роль, заданную для устройства контроллера.
Возвращаемое значение
Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (status) равно FALSE.
Комментарии
Чтобы зарегистрировать реализацию клиентского драйвера обратного вызова события, драйвер должен задать член EvtUrsSetRoleURS_CONFIG в указатель функции метода реализации, а затем вызвать метод UrsDeviceInitialize , передав заполненную структуру. Драйвер должен вызвать метод после создания объекта устройства платформы для контроллера.
Примеры
NTSTATUS
EvtUrsSetRole (
_In_ WDFDEVICE Device,
_In_ URS_ROLE Role
)
{
NTSTATUS status;
PFDO_CONTEXT fdoContext;
TRACE_FUNC_ENTRY(TRACE_FLAG);
TRY {
// Change the current role of the controller to the specified role.
// The driver might have stored the control registers in the device context.
// Read and write the register to get and set the current role.
}
TRACE_INFO(TRACE_FLAG, "[Device: 0x%p] Successfully set role to %!URS_ROLE!", Device, Role);
status = STATUS_SUCCESS;
} FINALLY {
}
TRACE_FUNC_EXIT(TRACE_FLAG);
return status;
}
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 10 |
Минимальная версия сервера | Windows Server 2016 |
Целевая платформа | Windows |
Минимальная версия KMDF | 1.15 |
Верхняя часть | ursdevice.h (включая Urscx.h) |
IRQL | PASSIVE_LEVEL |