PMINIPORT_GET_REGISTRY_ROUTINE 콜백 함수(video.h)

아티클
08/07/2023

HwVidQueryNamedValueCallback 은 레지스트리에서 검색된 지정된 데이터를 처리합니다.

구문

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

매개 변수

HwDeviceExtension

미니포트 드라이버의 어댑터별 스토리지 영역에 대한 포인터입니다. 자세한 내용은 디바이스 확장을 참조하세요.

Context

VideoPortGetRegistryParameters 함수에 대한 입력으로 지정된 드라이버 결정 컨텍스트에 대한 포인터입니다.

ValueName

항목 이름을 지정하는 NULL로 끝나는 유니코드 문자열에 대한 포인터입니다.

ValueData

VideoPortGetRegistryParameters에서 제공하는 ValueName과 연결된 버퍼링된 데이터에 대한 포인터입니다.

ValueLength

ValueData에서 버퍼의 크기(바이트)를 지정합니다.

반환 값

HwVidQueryNamedValueCallback은 작업의 상태 반환합니다.

설명

HwVidQueryNamedValueCallback 은 VideoPortGetRegistryParameters 호출에 전달된 선택적 미니포트 드라이버 함수입니다.

VideoPortGetRegistryParameters는 레지스트리의 어댑터 키에서 지정된 ValueName에 대한 사용 가능한 구성 정보를 수집한 후 HwVidQueryNamedValueCallback을 호출합니다.

HwVidFindAdapter 또는 HwVidInitialize는 드라이버 제공 HwVidQueryNamedValueCallback 함수, 디바이스 확장에 대한 포인터 및 드라이버 제공 컨텍스트 데이터(VIDEO_PORT_CONFIG_INFO 버퍼일 수 있음) 및 레지스트리에서 검색할 값을 명명하는 유니코드 문자열에 대한 포인터를 사용하여 VideoPortGetRegistryParameters를 호출할 수 있습니다.

드라이버 제공 유니코드 문자열이 파일 이름인 명명된 레지스트리 항목인 경우 HwVidFindAdapter 또는 HwVidInitialize는 VideoPortGetRegistryParameters의 IsFileNameParameter 인수를 TRUE로 설정할 수 있습니다. 이 사양의 경우 반환된 데이터는 명명된 파일의 내용이 됩니다.

VideoPortGetRegistryParameters가 HwVidQueryNamedValueCallback 함수를 호출하면 사용 가능한 구성 데이터를 처리합니다. 예를 들어 HwVidQueryNamedValueCallback 은 검색된 데이터를 사용하여 미니포트 드라이버의 액세스 범위를 확인하고 에뮬레이터 액세스 범위(있는 경우), 인터럽트 벡터 또는 인터럽트 IRQL(있는 경우) 등을 설정하고, VIDEO_PORT_CONFIG_INFO 버퍼와 미니포트 드라이버의 디바이스 확장에서 HwVidFindAdapter 함수로 제어를 반환할 수 있습니다.

또한 HwVidInitialize는 IsFileNameParameter가 TRUE로 설정된 VideoPortGetRegistryParameters를 호출하여 미니포트 드라이버 제공 HwVidQueryNamedValueCallback 함수가 명명된 파일의 버퍼링된 콘텐츠를 사용하여 어댑터에 마이크로코드를 설정할 수 있도록 할 수도 있습니다.

반환된 ValueData 는 스택에 있으므로 로컬로 참조할 수 있습니다. HwVidQueryNamedValueCallback 은 입력 HwDeviceExtension 의 다른 미니포트 드라이버 함수에서 사용하기 위해 반환된 정보의 일부 또는 전부를 저장하거나 입력 컨텍스트 를 데이터를 저장할 수 있는 위치에 대한 포인터로 사용할 수 있습니다.

HwVidQueryNamedValueCallback 은 페이징 가능으로 만들어야 합니다.