IWDFIoTarget::FormatRequestForRead 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. For more info, see Getting Started with UMDF.]

FormatRequestForRead 메서드는 읽기 작업에 대한 I/O 요청 개체의 형식을 지정합니다.

구문

HRESULT FormatRequestForRead(
  [in]           IWDFIoRequest     *pRequest,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
  [in, optional] PLONGLONG         DeviceOffset
);

매개 변수

[in] pRequest

형식을 지정할 요청 개체에 대한 IWDFIoRequest 인터페이스에 대한 포인터입니다.

[in, optional] pFile

읽기 요청과 연결된 파일 개체의 IWDFFile 인터페이스에 대한 포인터입니다. 기본 I/O 대상의 경우 이 매개 변수는 NULL이 아닌 매개 변수여야 합니다.

[in, optional] pOutputMemory

읽기 요청에 사용되는 버퍼에 액세스하는 데 사용되는 IWDFMemory 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] pOutputMemoryOffset

읽기에 사용되는 출력 메모리 오프셋을 설명하는 WDFMEMORY_OFFSET 구조체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

[in, optional] DeviceOffset

읽기에 사용되는 디바이스 오프셋에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.

반환 값

FormatRequestForRead 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

요구 사항

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

참고 항목

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET