HWN_CLIENT_SET_STATE回呼函式 (hwnclx.h)
由客戶端驅動程序實作以設定硬體通知元件狀態。 當使用者想要變更驅動程式的狀態時,就會叫用它。
語法
HWN_CLIENT_SET_STATE HwnClientSetState;
NTSTATUS HwnClientSetState(
[in] PVOID Context,
[in] PVOID Buffer,
[in] ULONG BufferLength,
[out] PULONG BytesWritten
)
{...}
參數
[in] Context
用戶端驅動程式內容資訊的指標。 此記憶體空間可供客戶端驅動程式使用。 它是由 WdfDeviceCreate 配置為架構物件內容空間的一部分。 如需詳細資訊,請參閱 HWN_CLIENT_REGISTRATION_PACKET 和 Framework 物件內容空間。
[in] Buffer
BufferLength 位元組的緩衝區,包含包含HWN_HEADER結構的緩衝區,包括指定要設定之硬體通知的一或多個HWN_SETTINGS結構。
[in] BufferLength
以位元組為單位的 緩衝區 大小。
[out] BytesWritten
變數的指標,指出函式所寫入的位元組數目。
傳回值
如果作業成功,則傳回STATUS_SUCCESS。 否則,傳回適當的 NTSTATUS 錯誤碼。
備註
藉由設定 適當的HWN_CLIENT_REGISTRATION_PACKET 成員,然後呼叫 HwNRegisterClient 來註冊此回呼函式的實作。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1709) |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | hwnclx.h |
IRQL | PASSIVE_LEVEL |