다음을 통해 공유

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 함수(wdfiotarget.h)

  • 아티클

[UMDF에만 적용]

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 함수는 드라이버가 파일 이름을 지정하여 I/O 대상을 열 수 있도록 드라이버의 WDF_IO_TARGET_OPEN_PARAMS 구조를 초기화합니다.

구문

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

매개 변수

[out] Params

함수가 초기화하는 드라이버 할당 WDF_IO_TARGET_OPEN_PARAMS 구조체에 대한 포인터입니다.

[in, optional] FileName

WDF_IO_TARGET_OPEN_PARAMS 구조체의 FileName 멤버에 대한 값입니다. 대부분의 드라이버는 하위 대상이 디바이스 네임스페이스 액세스를 지원하지 않는 한 여기에서 NULL을 지정합니다.

반환 값

없음

설명

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE 함수는 지정된 WDF_IO_TARGET_OPEN_PARAMS 구조체를 0으로 설정하고 Size 멤버를 설정합니다. 또한 구조체의 Type 멤버를 WdfIoTargetOpenLocalTargetByFile로 설정하고 드라이버가 파일 이름을 제공하는 경우 FileName 멤버를 설정합니다.

드라이버는 WdfIoTargetClose를 호출하여 I/O 대상을 명시적으로 닫을 수 있습니다. 드라이버가 대상을 명시적으로 닫지 않으면 프레임워크는 디바이스가 제거될 때 자동으로 대상을 닫습니다(I/O 대상은 기본적으로 디바이스에 부모로 설정됨).

예제

다음 코드 예제에서는 UMDF 드라이버가 WDF_IO_TARGET_OPEN_TYPE 설명된 대로 파일 개체를 사용하여 로컬 대상을 여는 방법을 보여 줍니다.

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1
대상 플랫폼 유니버설
최소 UMDF 버전 2.0
머리글 wdfiotarget.h(Wdf.h 포함)
IRQL 모든 수준

추가 정보

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_TYPE