DRIVER_PROXY_FEATURE_FLAGS 구조에는 현재 시스템 및 드라이버에 대한 DriverProxy 기능의 가용성 및 상태를 나타내는 기능 플래그가 포함되어 있습니다.
Syntax
typedef union _DRIVER_PROXY_FEATURE_FLAGS {
ULONG AsUlong;
struct {
ULONG Enabled : 1;
ULONG Reserved : 31;
};
} DRIVER_PROXY_FEATURE_FLAGS, *PDRIVER_PROXY_FEATURE_FLAGS;
구성원
AsUlong
단일 ULONG 값으로 기능 플래그의 전체 집합입니다. 이렇게 하면 초기화, 비교 또는 스토리지를 쉽게 초기화할 수 있도록 모든 플래그에 32비트 정수로 액세스할 수 있습니다.
Enabled
DriverProxy 기능을 사용하도록 설정하고 사용할 수 있는지 여부를 나타내는 단일 비트 플래그입니다. 이 비트를 1로 설정하면 IoCreateDriverProxyExtension 및 IoRegisterDriverProxyEndpoints와 같은 DriverProxy API 를 성공적으로 사용할 수 있습니다. 이 비트가 0이면 DriverProxy 기능을 사용할 수 없습니다.
Reserved
나중에 사용할 수 있는 예약된 비트입니다. 이러한 비트는 현재 사용되지 않으며 드라이버에서 무시해야 합니다. 향후 DriverProxy 기능 플래그가 확장될 수 있도록 예약되어 있습니다.
비고
이 구조체는 IoGetDriverProxyFeatures 에서 DriverProxy 핫스왑 가능 기능이 지원되고 사용하도록 설정되어 있는지 여부에 대한 정보를 반환하는 데 사용됩니다. 드라이버는 DriverProxy API를 사용하기 전에 이 함수를 호출하여 구조를 검색하고 Enabled 플래그를 확인해야 합니다.
Enabled 플래그는 다음을 비롯한 여러 시스템 조건에 따라 설정됩니다.
- 보안 커널이 실행 중이어야 합니다.
- DriverProxy 작업에 대해 시스템을 구성해야 합니다.
- 레지스트리 설정을 통해 DriverProxy 기능에서 드라이버를 제외해서는 안 됩니다.
- DriverProxy를 전역적으로 사용하지 않도록 설정하면 안 됩니다.
드라이버는 초기화되지 않은 비트에 임의 값이 포함되지 않도록 IoGetDriverProxyFeatures 에 전달하기 전에 이 구조를 0으로 초기화해야 합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| Header | wdm.h |