共用方式為

HWN_CLIENT_GET_STATE回呼函式 （hwnclx.h）

  • 發行項

由客戶端驅動程序實作以取得硬體通知元件狀態。 當使用者要求狀態資訊時，就會叫用它。

語法

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

參數

[in] Context

用戶端驅動程式內容資訊的指標。 此記憶體空間可供客戶端驅動程式使用。 它會由 WdfDeviceCreate配置為架構對象內容空間的一部分。 如需詳細資訊，請參閱 HWN_CLIENT_REGISTRATION_PACKET 和 Framework 物件內容空間。

[out] OutputBuffer

用於寫入硬體通知狀態的 OutputBufferLength 個字節的緩衝區。 如果函式成功，緩衝區會包含 HWN_HEADER 結構，包括一或多個 HWN_SETTINGS 結構。

附注  

OutputBufferLength 必須夠大，才能包含所有要求的設定。 如需詳細資訊，請參閱。

 

[in] OutputBufferLength

OutputBuffer 的大小以位元組為單位。

[in] InputBuffer

InputBufferLength 的緩衝區 位元組，其中包含保存一或多個 HWN_SETTINGS 結構的 HWN_HEADER，其中要求的硬體通知元件的標識符會儲存在 HwNId 位元段中。 此緩衝區可以是NULL。

[in] InputBufferLength

InputBuffer 的大小 位元組。

[out] BytesRead

變數的指標，指出函式所讀取的位元組數目。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，傳回適當的 NTSTATUS 錯誤碼。

言論

藉由設定適當的 HWN_CLIENT_REGISTRATION_PACKET 成員，然後呼叫 HwNRegisterClient，以註冊此回呼函式的實作。

  • 如果 InputBuffer 為 NULL，則輸出緩衝區將用來儲存 HWN_HEADER 結構，其中包含驅動程式所實作之硬體通知的所有設定。

    硬體通知元件的設定會儲存在 HWN_SETTINGS 結構中。 HWN_HEADER 結構的 HwNSettingsInfo 字段包含 HWN_SETTINGS 結構的陣列。

  • 如果 InputBuffer 不是 null 且格式正確，則會包含具有一或多個 HWN_SETTINGS 結構的 HWN_HEADER。 所要求硬體通知元件的標識碼會儲存在 HWN_SETTINGS 結構的 HwNId 字段中。 其餘設定應該是有效的設定或零。
  • 如果 OutputBuffer 不夠大，無法包含所要求的所有設定，則此函式不應將任何專案寫入至 outputBuffer 。 此外，它應該將 BytesRead 設定為 0，並傳回錯誤。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1709
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
標頭 hwnclx.h
IRQL PASSIVE_LEVEL

另請參閱

硬體通知支援

硬體通知參考