다음을 통해 공유

IWDFIoRequest::GetReadParameters 메서드(wudfddi.h)

  • 아티클

경고

UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.

GetReadParameters 메서드는 읽기 형식 요청에 대한 요청 매개 변수를 검색합니다.

구문

void GetReadParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

매개 변수

[out, optional] pSizeInBytes

읽을 크기(바이트)를 수신하는 변수에 대한 포인터입니다. 읽기용 데이터를 검색하기 위해 드라이버는 IWDFIoRequest::GetOutputMemory 메서드를 호출합니다.

이 매개 변수는 선택적 요소입니다. 드라이버가 정보가 필요하지 않은 경우 NULL 을 전달할 수 있습니다.

[out, optional] pullOffset

디바이스 또는 디바이스의 파일에서 읽기 시작하는 오프셋(바이트)을 수신하는 변수에 대한 포인터입니다. 디바이스가 절대 읽기 주소를 지원하지 않는 경우 pullOffset 을 무시할 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

클라이언트 애플리케이션은 OVERLAPPED 구조체의 Offset 및 OffsetHigh 멤버에서 이 값을 지정합니다. OVERLAPPED에 대한 포인터는 Microsoft Win32 ReadFile 또는 ReadFileEx 함수에 전달됩니다.

이 매개 변수는 선택적 요소입니다. 드라이버가 정보가 필요하지 않은 경우 NULL 을 전달할 수 있습니다.

[out, optional] pulKey

드라이버가 드라이버에서 결정하는 방식으로 I/O 요청을 정렬하는 데 사용할 수 있는 키를 수신하는 변수에 대한 포인터입니다.

이 매개 변수는 선택적 요소입니다. 드라이버가 정보가 필요하지 않은 경우 NULL 을 전달할 수 있습니다.

반환 값

없음

설명

요청 형식이 읽기 형식이 아닌 경우 GetReadParameters 에 대한 호출이 실패합니다.

주소 지정(예: 디스크 디바이스)을 지원하는 디바이스의 경우 pullOffset 매개 변수가 가리키는 값은 일반적으로 디바이스에 대한 바이트 오프셋입니다. 주소 지정(예: 직렬 포트)을 지원하지 않는 디바이스의 경우 드라이버는 pullOffset의 값을 무시할 수 있습니다.

드라이버가 pSizeInBytes, pullOffset 및 pulKey 매개 변수 각각에 대해 NULL을 선택적으로 지정할 수 있지만, 드라이버는 GetReadParameters가 성공적으로 실행되려면 NULL이 아닌 매개 변수를 하나 이상 지정해야 합니다.

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.5
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보