다음을 통해 공유

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 무시할 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

클라이언트 애플리케이션은 Offset 및 OffsetHigh OVERLAPPED 구조체의 멤버에 이 값을 지정합니다. 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

참고 항목