WdfDriverOpenPersistentStateRegistryKey 函式（wdfdriver.h）

發行項
2025-03-22

驅動程式應該使用 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

接收架構登錄機碼物件句柄之位置的指標。