WdfDriverOpenPersistentStateRegistryKey 函式 (wdfdriver.h)
驅動程式應該使用 WdfDriverOpenPersistentStateRegistryKey 將驅動程式寬持續性資訊寫入登錄。
語法
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[in] WDFDRIVER Driver,
[in] ACCESS_MASK DesiredAccess,
[in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
[out] WDFKEY *Key
);
參數
[in] Driver
驅動程式架構驅動程序物件的句柄，該驅動程式是從先前呼叫 WdfDriverCreate 或 WdfGetDriver 取得的。
[in] DesiredAccess
ACCESS_MASK型別值，指定登錄機碼的存取遮罩。 KMDF 驅動程式通常會要求 KEY_READ、 KEY_WRITE或 KEY_READ | KEY_WRITE。 如果您要撰寫 UMDF 驅動程式，請使用 KEY_READ 或 KEY_READ | KEY_SET_VALUE。 最佳做法是只要求驅動程式所需的存取類型。
[in, optional] KeyAttributes
呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，指定架構登錄機碼對象的物件屬性。 這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。
[out] Key
接收架構登錄機碼物件句柄的位置指標。
傳回值
請參閱 WdfDriverOpenParametersRegistryKey。
備註
金鑰 Parameters 適用於 INF 檔案中提供的 不可變 設定。 若要存取這些設定，請使用 WdfDriverOpenParametersRegistryKey。 從此 API 傳回的金鑰適用於在運行時間寫入的設定。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 (版本 1803) |
| 最低 KMDF 版本 | 1.25 |
| 最低UMDF版本 | 2.25 |
| 標頭 | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |