EVT_URS_SET_ROLE Rückruffunktion (ursdevice.h)
Die URS-Klassenerweiterung ruft diesen Ereignisrückruf auf, wenn der Clienttreiber die Rolle des Controllers ändern muss.
Syntax
EVT_URS_SET_ROLE EvtUrsSetRole;
NTSTATUS EvtUrsSetRole(
[in] WDFDEVICE Device,
[in] URS_ROLE Role
)
{...}
Parameter
[in] Device
Ein Handle für das Framework-Geräteobjekt, das der Clienttreiber im vorherigen Aufruf von WdfDeviceCreateabgerufen hat.
[in] Role
Ein URS_ROLE Typwert, der die rolle angibt, die für das Controllergerät festgelegt werden soll.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) WAHR ist. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE entspricht.
Bemerkungen
Um die Implementierung des Ereignisrückrufs des Clienttreibers zu registrieren, muss der Treiber die EvtUrsSetRole Member von URS_CONFIG auf einen Funktionszeiger der Implementierungsmethode festlegen und dann den UrsDeviceInitialize Methode aufrufen, indem die gefüllte Struktur übergeben wird. Der Treiber muss die Methode aufrufen, nachdem sie das Framework-Geräteobjekt für den Controller erstellt hat.
Beispiele
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Zielplattform- | Fenster |
| Minimale KMDF-Version | 1.15 |
| Header- | ursdevice.h (include Urscx.h) |
| IRQL- | PASSIVE_LEVEL |