存取篩選驅動程式的組態資訊
NDIS 支援一組函式,可提供篩選驅動程式登錄參數的存取權。 篩選驅動程式可以在附加或重新開機作業期間存取這些參數,或在處理 隨插即用 (PnP) 通知時存取這些參數。 如需 PnP 通知的詳細資訊,請參閱 篩選模組 PnP 事件通知。 如需附加篩選模組的詳細資訊,請參閱 附加篩選模組。 如需重新開機作業的詳細資訊,請參閱 啟動篩選模組。
篩選驅動程式會呼叫 NdisOpenConfigurationEx 函 式來存取登錄設定。 如果篩選驅動程式藉由呼叫NdisFRegisterFilterDriver函式來取得NDIS_CONFIGURATION_OBJECT結構的NdisHandle成員中的控制碼,NdisOpenConfigurationEx 函式會提供篩選驅動程式設定參數儲存位置的控制碼。 篩選驅動程式可以使用組態控制碼,直到它們呼叫 NdisFDeregisterFilterDriver 函 式為止。
如果篩選驅動程式從FilterAttach函式的NdisFilterHandle參數取得NdisHandle中的控制碼,NdisOpenConfigurationEx 會提供篩選模組組態參數儲存所在登錄位置的控制碼。 篩選驅動程式可以使用組態控制碼,直到 NDIS 中斷連結篩選模組並 傳回 FilterDetach 函式為止。 如果監視篩選驅動程式在 NDIS_CONFIGURATION_OBJECT 結構的 Flags 成員中指定 NDIS_CONFIG_FLAG_FILTER_INSTANCE_CONFIGURATION 旗標,當有多個篩選模組透過相同的迷你埠配接器設定時,驅動程式就可以存取特定篩選模組的篩選模組組態。 修改篩選驅動程式不得使用此旗標。
在驅動程式存取設定資訊之後,驅動程式必須呼叫 NdisCloseConfiguration 函式 來釋放設定控制碼和相關資源。